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SUMMARY 


INFORM was developed to aid assembly- language programmers of mini- and 
micro -computers in solving the man-machine communications problems that exist 
when scaled integers are involved. In addition to producing displays of quasi- steady- 
state values, INFORM provides an interactive mode for debugging programs, making 
program patches, and modifying the displays. Auxiliary routines SAMPLE and DAT AO 
add dynamic data acquisition and high-speed dynamic display capability to the program. 

This report contains detailed programming information and flow charts to aid in 
implementing INFORM on various machines. It also serves as a user's guide for the 
program. (An assembly language listing is available through COSMIC. ) The text is 
designed to be tutorial to novice programmers, yet not cumbersome to experienced 
persons. Detailed descriptions of all supportive software are provided. 

Throughout the report, consideration is given to possible program modifications 
to satisfy the individual user' s needs and to identifying likely modifications and explain- 
ing how they can be accomplished. The program is organized in a modularized, 
straightforward manner to simplify modifications and additions . 


INTRODUCTION 

The advent of the microprocessor and the reduction of the cost of computing ma- 
chines has led to the use of digital computers for control of everything from television 
games to sophisticated industrial processes. Ruggedized digital hardware is now en- 
tering the heretofore mechanical domain of automobile and aircraft controls and other 
applications in hostile environments . 

To be cost effective and to improve reliability, the number of parts in digital sys- 
tems is being cut to a minimum. Such reductions, along with requirements for in- 
creased computing speed, demand assembly or machine language programming tech- 
niques that use scaled-integer arithmetic calculations. Unfortunately for the program- 
mers of such systems, few aids exist that allow the programmer to think in terms of 
real-world values as is afforded by the use of higher level languages such as Fortran, 
Basic, and PL/M. This makes locating errors within assembly-language programs 
extremely difficult, increases the time required to get such programs up and running, 
and significantly increases the cost of software development. 



The INFORM program is designed to overcome such obstacles. It might be thought 
of as an assembly-language programmer's dynamic debug, development, and data col- 
lection tool. INFORM was developed to meet the needs of engineers who were develop- 
ing real-time digital controls under time and hardware constraints that made the use 
of integer arithmetic and scaled parameters necessary. The program was designed to 
meet the steady-state data display requirements of such controls. An interactive mode 
provides for dynamic display programming as well as some debugging and modification 
capability . The SAMPLE and DATAO subroutine additions were designed to meet dy- 
namic data collection and real-time data display requirements of transient data. 

Although originally developed on a 16-bit SEL 81 OB computer, the program was 
designed for diverse applications. It uses only 5 k words of the SEL core and is or- 
ganized in a modularized, straightforward manner, permitting easy addition to, or 
modification of the program to meet the recurring or one-shot needs of any specific 
programmer. The SAMPLE and DATAO programs are examples of additions devel- 
oped for the recurring needs of aerospace control systems being designed and tested 
at the Lewis Research Center (ref. 1). The use of these routines within the first year 
of operation saved sufficient time to justify the development costs. Aimed at general 
purpose applications, INFORM, SAMPLE, and DATAO have been used for nearly every 
project, large or small, performed by the SEL 810B propulsion control computer at 
the Lewis facility and are now being expanded to speed operation of Lewis’ s hybrid 
computing facility . 

The INFORM program makes extensive use of an efficient input/output library 
called CIPHER. The function of each subroutine contained within this library, as well 
as information regarding other required supportive software, is given in detail iif ap- 
pendixes A to I. 

The report first describes the overall capabilities of the INFORM, DATAO, and 
SAMPLE subroutines and how they are intended to operate within a user's system. 

The report then describes their operation. Details on the use of the interactive com- 
mand structure for accomplishing the possible tasks follows. Examples are given to 
illustrate use of the software within a system. The report supplies all the information 
required by programmers to translate the program to their machines. Execution 
times and core requirements are given for an SEL 810B computer. Complete explana- 
tions and flow charts are given for all facets of the program. Reasons for using par- 
ticular techniques are given to aid in the adaptation of the program to varing needs and 
to serve a tutorial function for novice assembly-language programmers. In addition, 
many possible modifications have been identified and explained. 

Functional assembly-language listings for SEL 810B computers are available upon 
request through COSMIC . 
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PROGRAM DESCRIPTION 


To understand how INFORM, SAMPLE, and DATAO operate, we will first discuss 
how these subroutines are incorporated into a functional system. Being subroutines, 
these programs do not set up an interrupt environment, nor do they perform t iming 
functions usually performed by an executive . Instead, they are designed to operate in 
a user- structured environment. Two examples of how they fit into a typical operational 
environment will be given. An overall description of what each subroutine does follows 
these examples. All numerical values within the user's program to be manipulated by 
the INFORM, SAMPLE, and DATAO software are assumed to be integers representing 
parameters that have been scaled to range between the negative and positive integer 
value limits of the machine. The program also handles unity scaled integer parame- 
ters. 

For clarity, this report makes a distinction between operators, programmers, and 
users. The term "operator" refers to a user who is conversing with INFORM in an in- 
teractive environment. "Programmer" refers to the person or persons who have im- 
plemented the INFORM software or its calling main programs on the user's computer 
and are responsible for the object modules. The term "user" is used when no distinc- 
tion need be made between an operator or programmer. An operator or programmer 
is always a user, but the reverse is not always true. 


Interface to User's Environment 

The INFORM package comprises four independently callable subroutines: INFORM, 
DATAO, SAMPLE, and CLRSMP. Specifics of the calling sequences and use of each 
subroutine are given in a separate section of the report. Although they may be called 
by any main program, they are primarily intended to be executed on the lowest or 
"spare-time" levels of a priority interrupt system, where the main function of the com- 
puter (e.g. , a process control algorithm) is executed on higher levels. These higher 
levels are usually driven by recurring external interrupts such as those of a real-time 
clock or interval timer. When used in this fashion, the command structure made avail- 
able to the operator by INFORM creates an interactive operating environment for any 
passive, real-time program. Further, the programmer creates this environment by 
simply defining the interrupt structure and executing a simple CALL INFORM state- 
ment on the lowest level. 

If the system also uses the digital computer for data collection, a simple call to 
SAMPLE, where the storing of data would normally be programmed, gives the INFORM 
subroutine interactive control over the data-collection process. This allows the oper- 
ator to store any parameter available within the machine at the time of call. The oper- 
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ator also gains the ability to restructure the available storage. For example 200 time 
points of 20 variables, 800 time points of 5 variables, or one time point of 4000 varia- 
bles are all possible with 4 k words of storage, hi addition, using the SAMPLE sub- 
routine automatically provides a means for transferring the stored data to a bulk stor- 
age device by means of INFORM' s interactive command structure . 

In a similar manner, dynamic displays of system variables may be controlled by 
the INFORM subroutine if the programmer uses the DATAO subroutine for his displays . 
The programmer need only insure that all parameters to be displayed are in the core 
and that DATAO is called in the interrupt sequence every time he wishes to update the 
display. All programming is then complete to give the operator interactive control 
over the display. The operator may then select which parameters are displayed and 
expand or compress scales at will without concern for scaling or recalibration of the 
display recorders . As written, DATAO is intended for use with fixed-calibration ana- 
log displays using 0- to 10- volt inputs, but it may be modified to work with any display 
that can be driven to its scale extremities by system digital-to-analog converters 
(Dacs) . 

Figures 1 and 2 show the execution sequence of the INFORM, DATAO, SAMPLE, 
and CLRSMP subroutines for a typical system. The updating of the main program is 
controlled by the system clock, with data samples being saved by SAMPLE every sixth 
clock period. The DATAO display is updated every other clock period. If sufficient 
time is available between updates to execute the main program and update SAMPLE or 
DATAO, a simple one-level interrupt scheme (as shown in fig. 1) will suffice. In this 
system the system clock interrupts the INFORM background task and forces execution 
of the main program . After each completion of the main task, a decision whether 
SAMPLE or DATAO should be updated is made before returning to INFORM . The flow 
chart for such a system is shown in figure 2 . Flow-chart symbols are defined in ap- 
pendix G . 

A multilevel interrupt sequence may be executed as shown in figures 3 and 4. This 
system no longer requires that sufficient time be available during each update to exe- 
cute SAMPLE or DATAO . Instead, it may be treated as any other interrupt level with 
its execution being determined on a priority basis with requests for service being gen- 
erated by devices such as system clocks or direct memory access controllers . In such 
an asychronous environment, conflicts might arise when attempting to change the 
DATAO display or to restructure the SAMPLE storage through use of INFORM com- 
mands while higher priority routines are using SAMPLE and DATAO. Such problems 
have been eliminated within the INFORM software, provided the INFORM interactive 
commands are always performed on a lower level of priority than DATAO, SAMPLE, 
or CLRSMP. 
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Figure 1. -Typical execution sequence for systems using one priority interrupt. 
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Figure 3. - Typical execution sequence for multilevel interrupt system with data input through direct-memory access channels. 
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input through direct-memory access channels. 

























INFORM, DATAO, SAMPLE, and CLRSMP provide nearly everything the program- 
mer requires to perform the complete data collection and display task. INFORM does, 
however, require use of some additional software in the form of standard Fortran 
arithmetic routines and a special input/output (I/O) library. The effect on the oper- 
ating environment of the specifics of the particular Fortran library available to the 
programmer cannot be given here because it will vary from machine to machine. The 
I/O library used is the CIPHER library developed at Lewis. It is this library that is 
responsible for many of the convenience features available in INFORM. A complete 
list of all required subroutines and their functions is given in appendix F. 


INFORM Subroutine 

The INFORM subroutine provides an on-line display and data manipulation capabil- 
ity for single-precision, integer values retained in absolute memory. The operator 
programs the display while the program is running in the interactive mode. Memory 
locations are referred to by operator-assigned, one- to five-character, alphanumeric 
names. Values for these named locations may be displayed in engineering units (EU) 
or octal. INFORM determines these EU's by multiplying each integer value by a scale 
factor associated with the name. Once defined, the names and their associated loca- 
tions and scale factors remain fixed unless redefined by the operator. 

The display may be one of five types. Four are tabular, and the fifth is single- 
variable interactive . The display may be produced on any available I/O device . Up to 
three different data -table sequences, any one of which may be in any of the four tabular 
formats, may be saved for use by the display. To save laborious reprogramming, a 
load-or-dump option enables the operator to load previous definitions of named loca- 
tions and data-table sequences, or to save the existing definitions via a relocatable 
binary-dump tape. This option is especially useful when INFORM is used for pro- 
grams that have their named locations defined as being in common core. In this case 
programs may be updated and reloaded without having to redefine the INFORM names. 
As long as the common locations remain fixed, the dump tape may be used to "teach" 
a new load the old definitions . 

Three modes of INFORM operation are possible, one interactive and two passive. 
In the interactive mode, the operator can issue a command and obtain an immediate 
response. In this mode the operator can define variable names, scale factors, and 
locations; display current values of named locations in octal, decimal, EU, or other 
programmed formats; display the results of numerical calculations in either octal or 
decimal; display, in EU's, ratios, or other algebraic combinations of named loca- 
tions; and alter or set named locations to given or calculated values. The sequentially 
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formed arithmetic expression (SFAE) as described in appendix B is the basis for nu- 
merical or algebraic calculations . 

A default-name (no name) option allows temporary definitions for display or per- 
manent alteration of any value in core . Alterations are made in a format that is con- 
venient to the operator as well as in the machine’s inherent binary code, thus enabling 
program patches for debugging purposes. 

The two passive modes of operation are a data-table-printout mode and a variable- 
trip mode . Only one mode of operation may be in effect at a time . A change from the 
active mode to one of the passive modes or vice versa is accomplished by a sense 
switch, which is tested each time INFORM is entered and upon completion of a data- 
table printout. If the data-table printout is selected as the current passive mode, a 
data table is printed each time INFORM is entered. The data-table format and the I/O 
device for this display may be specified when the program is in the interactive mode . 
Also in this mode, the operator may select the third or variable-trip mode as the cur- 
rent passive mode. This mode will suppress a data-table printout until a specified 
named location becomes either greater than, less than, or equal to a defined trip point. 
When the trip condition is reached, an optional computer halt, before the table printout, 
is possible. More detailed information on how to select and enter the different modes 
of operation is given in the Program Operation section. 


DATAO Subroutine 

DATAO is used to display the values of INFORM named locations on analog devices 
driven by system Dacs. The routine is designed for high- rate operation so that it can 
provide acceptable displays when used for transient data . Speed of execution on the 
SEL 810B is 5 microseconds plus 50 microseconds for each Dac written. Normally, 
DATAO is programmed to drive fixed- calibration recorders whose scale extremities 
correspond to inputs of 0 and +10 volts. To protect such recorders, output voltages 
are limited to -0.1 and +10.24 volts by DATAO . The EU values that correspond to 
these levels, as well as the named location to be assigned to any given Dac, or record- 
er, may be defined or altered when in the INFORM interactive mode. Hence, the oper- 
ator has the ability to expand, compress, shift, or reverse scales without having to ad- 
just recorder gains or repeat recorder calibration. 

A load-or-dump option is also available for the definitions of the DATAO display 
channels . If less than 24 DATAO channels are defined, the unused channels are 
skipped, and no execution time is required for those channels . The maximum channel 
limit of 24 is a programmer's option and may be changed. 
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SAMPLE Subroutine 


SAMPLE is a transient data collection routine that samples and stores values of 
INFORM named locations. Designed for dynamic data collection, its execution time is 
only 15 microseconds plus 24 microseconds per sample taken on the SEL 810B comput- 
er. The named- location values to be saved and the memory locations to be used to 
store the values collected are defined or altered in the INFORM interactive mode. The 
operator must also define the size of the storage blocks (i.e. , the number of samples 
to be saved for each variable) and an averaging parameter used for an optional data 
filtering mode. A relocatable binary-dump tape option similar to that provided for 
INFORM is available for these definitions. 

In the simplest form of operation, one value for each specified variable is sampled 
and stored each time SAMPLE is called by the main program. The operator specifies 
the variables to be sampled by defining SAMPLE channels; that is, by specifying a 
named location to be sampled and the location of a storage block to be used to save the 
samples. The length, which is common to all storage blocks, must also be defined by 
the operator. Each time the main program calls SAMPLE, it also supplies a sample 
number that indicates the relative location in the storage blocks to be used for storage. 
Each time SAMPLE is called, SAMPLE stores one sample for each currently defined 
SAMPLE channel in this relative location. If a sample number received from the main 
program exceeds the defined storage-block lengths, no samples will be stored, and the 
return to the calling program will be diff erent to indicate that all samples have been 
taken. The main program may then use this information to stop the sampling process 
or to recycle . 

Another mode of operation of SAMPLE is possible: Instead of storing each sample 
in its relative location, it is added to a summation value already stored in the relative 
location. This mode is intended for the averaging type of data filtering. The summa- 
tion values are automatically divided by the number of points added together (i. e. , an 
averaging parameter supplied by the operator) when the sample values are output. The 
sampling mode is determined by the value of the averaging parameter defined by the 
operator. If the averaging mode is in effect, the main program, which calls SAMPLE, 
must also call CLRSMP to set the initial summation value to zero . 

If averaging is being used, the storage-block length defined by the operator must 
be at least two times the number of samples to be taken. The extra locations are 
needed to store the summation as a double-precision value . 

The contents of any or all of the storage blocks may be dumped in either of two 
fixed formats on any available I/O device. The output includes a coded number to in- 
dicate the first and last variables dumped, the scale factors, the number of samples 
per variable, and the data in integer or floating-point format. When integers are out- 
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put, they represent the scaled values; while the floating-point data are output as EU 
values . The formats provide for convenient interpretation by the user and for interfac- 
ing with Fortran data- reduction programs . Integer valued checksums are provided for 
each line of output. For further details consult the APPLICATIONS AND EXAMPLES 
section and the $1 and $2 command descriptions in appendix C (pp. 82 and 84). 

The operator may also scan data collected by SAMPLE by using an INFORM com- 
mand designed to list core. Details of this procedure are given in the APPLICATIONS 
AND EXAMPLES section. 


CLRSMP Subroutine 

CLRSMP is provided to set the values in all the SAMPLE -channel storage blocks 
to zero . It must be called to initiate the start of a new summation for the averaging- 
filter mode of SAMPLE . CLRSMP may also be called if SAMPLE is not in the averag- 
ing mode . However, it should never be called by the main program until the operator 
has dumped the sampled values in the storage blocks, as these values are destroyed by 
CLRSMP. 


PROGRAM STATISTICS 
Core Requirements 

Because different users will implement different portions of the program, the core 
requirements are broken down into convenient categories (table I, p. 14). Although the 
values shown are for an SEL 810B computer, they should be typical for any 16-bit, two- 
accumulator machine with index register. 


Calling Sequences 

The calling sequences given herein are for the SEL 810B computer. The 810B is 
a 16-bit minicomputer with a maximum addressing range of 32 k words. It is a two- 
accumulator machine with index register and uses two’s complement arithmetic. Ad- 
dressing is either direct or program-counter relative. Infinite indirect addressing 
with either post- or pre-indexing is available. Two-operand instructions always use 
an accumulator as one of the operands. Memory cycle time is 750 microseconds, with 
most memory referencing instructions requiring two memory cycles for execution. 

Use of indexing or indirecting requires one additional memory cycle for each indirect 
or indexing operation. Implied operand or single-register instructions require one 
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memory cycle for execution. When both indirect and indexing appear in the same in- 
struction, indexing is done before the indirect. 

The call to INFORM must be followed by a coded data word to indicate the type of 
format desired for passive-mode data table printouts. The meaning of the bits of the 
coded word are defined in figure 5 . The least significant three bits of the word are an 
output unit number. The next most significant three bits are a data table number, and 
the least significant three bits of the bits remaining signify the type of format. If any 
of these three-bit values is zero, default values DFO, DF1, and DF2, as defined by 
the operator, are used for the format type, data table number, and output unit number, 
respectively. On program load or re-initiation of the program due to a definition-dump 
read-in error, these default values are set to initial values. 

When SAMPLE is called, the hardware A accumulator must contain the sample 
number. The first location following the call is the abort return location used when the 
sample number supplied lies outside the currently defined storage-block length. The 
second location following the call is the normal return location. Whenever it is desired 
to clear the SAMPLE -program-storage blocks, simply call subroutine CLRSMP. 

There is no special calling sequence for DATAO. Simply call DATAO whenever it 
is desired to update the Dac display . 


Timing 

The times given below are for the SEL 810B computer. The execution time for 
SAMPLE in the nonaveraging mode is approximately 15 microseconds plus 24 micro- 
seconds per channel sampled. The averaging mode requires 16 microseconds plus 
36 microseconds per channel. The timing for CLRSMP is the same as for the non- 
averaging mode of SAMPLE . The time required to execute DATAO is approximately 
5 microseconds plus 50 microseconds per channel displayed. INFORM requires 
10. 5 microseconds per named location to collect the data for a data table printout. A 
time lag of approximately 66 microseconds plus 18 microseconds per named location 
occurs between entry of subroutine INFORM and the start of data collection. 


DESCRIPTION OF PROGRAM OPERATION 

Certain definitions and conventions will be used when describing the operation of 
the program. For reference, these conventions are listed in appendix B. 
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16 - bit 
data word 



Unused bits 


Format 

type 

Data table 
number 

Output unit 
number 

°l 

1 | 2 | 3 | 4 | 5 

6 

7 | 8 | 9 

10 1 11 1 12 

13 1 14 1 15 


Figure 5. - Format for coded data word used when 
calling INFORM to establish form of passive-mode 
data-table printouts. 


TABLE I. - CORE REQUIREMENTS FOR SEL 810 B SYSTEM 


INFORM: 

Main program, and subroutines 776 

Command processors (excluding >, <, /, [ , and ] commands) . . . 286 

Named location definition tables (250 names) 1251 

Data tables 179 

STOR (temporary storage buffer) 174 

Default options and processors 384 

3050 

SAMPLE: 

Central command processors (< and > commands) 208 

Channel definition tables (80 channels) 165 

SAMPLE subroutine 43 

CLRSMP subroutine 13 

429 

Command Processor common to DATAO and SAMPLE 131 

DATAO : 

Control command processor (> command) 200 

Channel definition tables (80 channels) 169 

DATAO subroutine 40 

409 

INPUT/OUTPUT subroutines: 

MESAGE 27 

OUT00, OUT10 45 

OUT11, OUT12, OUT22, OUT21, and OUT44 243 

PUNCH, LOAD, VERIFY 115 

TRYR, TTYR2 207 

FDDH, FDDEND, FDD11, FDD12, FDD22, FDD21 , FDD44 105 

INPT, AIP, AOP, AIPX, AIPRX, and AOPX 93 

835 

Fortran arithmetic and conversion 519 

Grand total 5373 
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INFORM Mode Selection 


Mode selection is most easily understood by following the flow chart of figure 6. 

In general, the interactive mode may be entered at any time by setting the operator's 
mode-select switch (a sense switch) . The passive mode may only be entered immedi- 
ately following entry from the calling program with the operator's mode-select switch 
reset. Entry of the variable-trip mode is controlled by the variable-trip-mode latch 
(VTLH), which is set or reset by interactive mode commands. The variable-trip mode 
will not be entered until the INFORM subroutine is exited and re-entered with the oper- 
ator* s mode-select switch reset and VTLH set. 


Use of Commands 

Generally, INFORM is run in the interactive mode with the user obtaining informa- 
tion from the program by issuing a command and observing the response. A command 
consists of a key character preceded and/or followed by substantiating characters 
called operands. For example, if we desire the current value for a parameter called 
SPEED, we would type 


SPEED= 

Here, = is the key character and the name "SPEED” is an operand. If the operands 
follow the key character, they must be separated from the key character by a space or 
comma. A complete list of commands and an explanation of their operands and func- 
tions for INFORM, DATAO, and SAMPLE are given in appendixes C to E. 

Commands are separated into three groups: control-edit commands provided by 
INFORM, commands used to control the DATAO subroutine, and commands used to 
control the SAMPLE subroutine . The = command of the above example is an INFORM 
control-edit command. The operator always knows when the program is ready to ac- 
cept a command as it will print an underscore for control-edit commands, < for 
SAMPLE control commands, or > for DATAO control commands at the beginning of 
a new input line it creates by supplying a carriage return and line feed to the opera- 
tor' s input console . This character is followed by the ringing of the bell on the con- 
sole. Assuming SPEED has a current value of 1500 rpm, the complete line for the 
preceding example would be 


_SPEED=__]50gg : 01 

The underscore is used throughout this report to indicate characters printed by the 
machine, thus separating them from operator entries. 
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The decimal value produced by the program is actually the EU value printed in the 
Fortran format of 5PE10.5 except that the decimal point, which occurs to the right of 
the five-digit mantissa, and the E are omitted. This format is used for all displays 
of decimal numbers, as it increases speed of printout on slow I/O devices and shortens 
line length for cathode-ray tube (CRT) devices. Little readability is sacrificed since 
the beginning of the exponent can always be identified by the space or minus sign follow- 
ing the mantissa. The increased speed and shortened lines are especially beneficial 
when lengthy data table printouts occur. Hence, the above value is 1,500. 0 If the octal 
value were being displayed, it would be indicated by an apostrophy preceding a six- 
digit octal value. These formats are characteristic of the OUT22 and OUTOO subrou- 
tines of the CIPHER I/O library (ref. 2), and hence may be changed accordingly. 

It is not always necessary to enter all operands listed for a command. Some oper- 
ands may be defaulted (omitted). Those operands that may be defaulted have default 
values listed under their description in the appendices . If the operand is defaulted, the 
default value will be used. For example, if we wish to display the value of SPEED a 
second time, we need only type the ,, = M key character, since the default value for the 
operand is the name operand used by the previous command, that is, SPEED. 

Thirteen of the default values of the various commands are modifiable by the user 
or operator. These defaults are identified as DFO through DF12. The programmer 
can alter them by changing the initial values within the INFORM software. The opera- 
tor can change them using the change default value command. These default values 
are included on INFORM definition-dump tapes. Hence, the status of the defaults when 
the dump was produced will be restored whenever the dump is loaded. 

Commands are processed character by character but are not executed until all en- 
tries have been received. This enables the user to maintain the status quo by cancel- 
ling the command before completion by entering "#" (ASCII ’245). A successful can- 
cellation will be indicated by "?" printed on the operator's console. If the operator 
types an erroneous or illegal operand, the program will cancel the entire command 
line and indicate same by typing "?" on the operator's console. 

Most commands, unlike the "=" command, have additional operands following the 
key character and, therefore, require a terminating character to indicate the end of 
the operand entries. This terminating character is a carriage return. If a carriage 
return occurs before the entry of all operands, it is assumed that the remaining oper- 
ands are defaulted. If no default value exists for one of these remaining operands, the 
"?" error message is issued. 

Defining named locations . - If, in the preceding example, the location and scale 
factor (Sf) for SPEED had not been previously defined, the machine would have issued 
the error message "U ?" and cancelled the instruction. To be able to use SPEED as a 
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name operand, it must have been previously defined using the "space" define- redefine 
variable name command. Using the "space" command on a variable name that has al- 
ready been defined invokes the redefine name processor and causes the subsequent new 
definition to replace the existing definition . 

To define a name using the "space" command, the name to be defined must precede 
the "space" entry. A name must consist of from 1 to 5 of the 36 possible alphanumeric 
characters, with the first character being one of the 26 alphabetic characters. No de- 
limiter, such as a space or comma, is needed to separate the "space" commands from 
its operands, as the machine will type a double asterisk or the word "REDEF" follow- 
ing the "space" to alert the operator that operands for a permanent name definition are 
to follow. If the new name being defined is not unique, or is not the same as a name 
being redefined, an error message will be received, and the command will terminate. 
The error message "Q?" indicates that the name-learning capacity has been reached 
and no new names may be defined unless old names are redefined. 

A typical line to define SPEED using the space command would look as follows: 

_SPEED **'256,15000/32000 

Note that the above line was terminated with a carriage return. To define a name, 
entry of the location and scale factor corresponding to the name used must follow the 
double asterisk or "REDEF" message (i.e. , SPEED). Once these entries are made, 
the name is properly defined and will appear on any subsequent relocatable binary- 
dump tapes. If one wishes not to proceed with the definition, the line must be can- 
celled by entering "#" before the carriage return. 

Of the two operands required to define a name, the location must be entered first. 
It may consist of any sequentially formed arithmetic expression as defined in appen- 
dix B. If a name occurs within the expression, the location, as currently defined for 
that name, is used as the numerical value. The only restriction is that the calculated 
value must be a legitimate core location. To facilitate the defining of names for suc- 
cessively increasing locations, the location entry may be defaulted by entering only a 
comma where the octal or decimal address would be. In this event the address is as- 
sumed to be one greater than the address defined for the last-used name operand of 
previous commands. When an address is defaulted, the calculated value is displayed 
to the operator before the acceptance of following characters. 

The address thus entered must be followed by the scale factor (Sf), which may 
consist of any sequentially formed arithmetic expression defined in appendix B. If a 
name occurs within the expression, the scale factor as currently defined for that name 
is used as the numerical value. The resulting Sf becomes the number to be used to 
multiply by a machine -stored number to produce the EU value. The use of the divide 
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option of the sequentially formed arithmetic expression facilitates the entry of frac- 
tions, such as, 100 percent per 2**(15) (the largest 16-bit word or IS) or 15 000 rpm 
per 32 000, where 32 000 counts are produced by an analog-to-digital converter for a 
10-volt input. These entries could then look like 100/1S and 15000/32000. If the value 
entered is zero, the scale factor is assumed to be one, and an octal instead of decimal 
display of the number is desired. 

To change a name, or to replace an existing definition with a new one, we proceed 
as before except that the old name must precede the "space" and the new name must be 
entered as the first operand. For example, 

_SPEED REDEF_REVS,' 256, 1000/ 32000 

would redefine SPEED as the new name of REVS and change its scale factor to 1000/ 
32000. 

Notice that a core location may have any number of different names and scale fac- 
tors assigned to it. However, each name must have a unique location and scale factor 
associated with it. Storage for a maximum of 250 different names is provided, but it 
is a simple matter to change this to any value between 1 and 254 . 

Data input and output control . - Data input and output are controlled through use of 
INFORM interactive commands (appendixes C to E) and by the user’s manipulation of 
the INFORM operating mode. Displays produced by DAT AO and samples taken by 
SAMPLE will, in general, also be under some form of control provided by the calling 
program. This procedure is illustrated in the section Applications and Examples for a 
typical operating system. The displays and manipulations provided by the INFORM 
software are described in the next section. 

Data tables . - When and how any of the three data -table sequences (data tables 1, 

2, or 3) gets printed is determined by the INFORM operating mode. These modes 
were previously described and illustrated in figure 6. The table number, format type, 
and unit used for passive-mode printouts are governed by the coded data word (fig. 5) 
following the INFORM calling statement and the values of defaults DF0, DF1, and DF2. 
If the format type supplied by the coded data word is zero, DF0 will be used as the for- 
mat type. In this event, if DF0 is not one of the four defined types of format (0, 1, 2, 
or 3), an error will occur and the program will revert to the interactive mode. A sim- 
ilar situation exists for the data table number and DF1. Default value DF2 will be used 
as the unit number whenever the coded data word supplies a unit number of 0. If print- 
out is initiated in the interactive mode, the operands of the "form" command supply 
these parameters. 

An example of formats 1, 2, and 3 for displaying data in tables is given in figure 7. 
Format 0 is designed for computer to computer communication dumps. It is identical 
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to the $2 dump format used for dumping SAMPLE data and is described in appendix C . 

In the type 1 format, a heading is printed first, then the data. In the type 2 format, 
only the data are printed. In the type 3 format, the variable name is printed, followed 
by an equal sign and the data. Note that for formats 1 and 2, each variable takes up 
10 spaces of the line, while in format 3 each one requires 18. If an attempt to print an 
undefined data table is made, an error message will be issued, and the program will 
immediately revert to the interactive mode . 

The number of variables printed on each line of a data table, their names, and the 
occurrence of any blanks within a given table are set by the operator. Three data-table 
sequences are provided and are referred to as data tables 1, 2, and 3. To define or 
alter one of the three stored data-table sequences, the data table being mo difi ed must 
first be in the open condition by applying the or "(" command. Only one table may 
be open at any one time. Once open, the names, line-terminators (carriage-return- 
line-feeds), or blanks may be added using the ”, ” and commands. The last line of 
the table may be removed using the "f" command. Once set, the named- location vari- 
ables in a table will remain fixed unless a given name is redefined with the "space" 
command. The new named-location subsequently defined will then replace the old 
variable in the table . 

A named location may occur any number of times within a table or tables. How- 
ever, each occurrence will count as an entry in the table . Line terminators and blanks 
also count as entries. Up to 200 entries for table 1, and up to 86 entries each for ta- 
bles 2 and 3 are allowed. These values, however, may be increased or decreased by 
a simple program change. 

Once completed, a data table should be closed using the ")" command to prevent 
accidental modifications. Appendix C, as well as the APPLICATIONS AND EXAMPLES 
section should be referred to for a clarification of this procedure. 

To minim ize data skew between variables, the program gathers the current values 
for all the named locations of a data table at a fast rate before the table printout. For 
the SEL 8I0B this rate is 10.5 microseconds per point. An additional time lag (ap- 
proximately 66 jusec plus 18 p sec per point for the SEL 810B) occurs between the issu- 
ance of a printout command and the time the first data point is fetched. Hence, to be 
time consistent, the values in core need be constant for only a short time immediately 
before a data table printout. 


DATAO Displays 

As previously described, updating of the display produced by the DATAO subrou- 
tine is governed by the main program and the operating environment established by the 
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programmer. Thus, the operator has no control over how the display is produced, but 
he does have full control over what is displayed. This control is obtained by entering 
the DAT AO control command processor of the interactive mode. This routine is en- 
tered from the normal INFORM control-edit command-acceptance routine by using the 
> INFORM control-edit command. The program will return > instead of the under- 
score to indicate readiness to accept DATAO control commands. A return from this 
routine to normal INFORM control-edit command acceptance is accomplished using the 
underscore DATAO control command. The DATAO subroutine control commands are 
listed in appendix D. 

Displays from the DATAO subroutine are referenced by channel number. The 
24 channels available are labeled 0 to 23. Assigned to each channel is a single named 
location, two EU values representing zero and full-scale outputs, an output unit num- 
ber, and a Dac channel number for the output unit. Two operands are used to define 
a Dac because both a unit number and the Dac number are required for the SEL 810B 
system. Other systems may require only one of these parameters. This determina- 
tion must be made by the INFORM programmer. All of these values for each channel 
must be defined by the operator before a display of that channel will occur. Only unit 
and channel numbers corresponding to system Dacs are accepted. Channel numbers 
must be defined sequentially, but, once defined, they may be modified, but not deleted, 
at any time. Only the highest number channel may be deleted. 

For example, if we desired to create several DATAO displays of the SPEED pa- 
rameter, we would proceed as follows: 

> 

>A 00__SPEED, -15000, 15000, '60,0 
>A 01 __, 10000, 11000, '50,0 
>A 02__, 0,15000, '60,1 
>A 03__, 0,-15000, '60, 2 

Here, we have created four channels to display SPEED. Notice the good use of the 
name-default option when defining channels 1 to 3. Thus, Dacs 0, 1, and 2 of Dac 
unit *60 have been assigned to DATAO channels 0, 2, and 3. For the example system, 
these Dacs are physically connected to strip-chart recorder channels 0, 1, and 2. 

Since these strip charts are always calibrated to linearly display 0 volt on the left 
and 10 volts on the right, the strip chart will linearly display SPEED in rpm. Strip 
chart 0 will display the full range of possible speeds from -15 000 to +15 000 rpm, 
negative speed being defined as opposite rotation from positive speed. Strip chart 1 
will display only positive speeds, and strip chart 2 only negative speeds. Notice that 
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we have flipped the axes on this chart so that negative speed dynamics will look the 
same as positive speed dynamics. 

For this particular example, an area of interest might be the dynamic behavior 
around 10 500 rpm. To observe this region in detail, we have chosen to assign Dac 0 
of unit '50 to DATAO channel 1. This Dac is physically connected to an X-Y recorder 
whose X axis is synchronized to a transient generator being used to evaluate the dy- 
namics of our system. Since this display will overwrite itself, the change in transient 
behavior as system parameters are changed can be seen immediately. Using INFORM 
as shown above, this device was calibrated to display only values between 10 000 and 
11 000 rpm, thus greatly improving the resolution and readability in the area of inter- 
est. Should interest later shift to some other area, such as the transition through 
zero, the X-Y recorder could be recalibrated by simply changing channel 1 to 

>C1 SPEED,- 100, 100, 1 60,0 

Since everything except the calibration remains the same, extensive use of defaults 
could simplify the entry to 

>C1 ,-100,100 

This shortened entry saves time and helps keep our concentration on the area of inter- 
est, namely, control performance, not Dacs and displays. 

Notice that if time was available inside the computer as an integer- valued variable, 
this time parameter could be used to drive the X axis of the X-Y recorder. In that 
case we could connect a system Dac to the X axis, calibrate the recorder X axis for 
0- to 10-volt operation, and define an appropriate DATAO channel. 

There are some restrictions and considerations associated with the selection of 
EU values to calibrate the display. Generally, they are of sufficient latitude to be of 
no concern to the user, but an explanation of the process used by DATAO to produce a 
display may prove enlightening. For the ensuing discussion, define a maximum EU 
value (MAX) as the biggest EU value that can be scaled into a 16-bit, binary word; that 
is, 

MAX = Sf x 2 15 

Let W be the EU value of a 0-volt output and X the EU value of a 10-volt or full- 
scale output. 

Restrictions are necessary to prevent overflow of the integer arithmetic used when 
producing the display. These restrictions are 
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MAX 


< | W - X| < 32 x MAX 


and 


2 


15 


MAX < |W| 


Failure to meet these restrictions will result in the error message "SPOF" and a ter- 
mination of the command. 

A point to consider when selecting W and X is the accuracy of the display . Be- 
cause of the integer arithmetic used, accuracy may suffer, depending on the scaled 
values of W and W - X. The operation performed by the program is as follows: 


Number output to the Dac = 


VxKl 


+ K2 


,K3 


where V is the scaled value of the output variable and K1 and K2 are defined as 


K1 


10 V 
X - W 


Sf x4x2' K3 


K2 = - 


K1 xW 
4 x Sf 


The K3 is selected by the program such that 

2 14 < | K] < 2 15 


and has the restriction that 


-15 < K3 < 15 

This mathematics produces the desired output which is 

Output as a fraction of 10 V = 

(X - W) 

The V • K1 multiplication is 16- by 16-bit integer for a 31-bit product. The K2 

K3 

is a 31-bit constant, and the 2 -multiplication is performed by a full arithmetic shift 
followed by a truncation to 15 bits. A more detailed analysis of this arithmetic is 
given in the PROGRAM STRUCTURE section. 

Since K1 is held between 2 14 and 2 15 , the accuracy of the calculation depends 
mostly on the values of K2 and 2 K3 . The 2 K3 shift will effectively truncate when 
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K3 is less than 0. Hence, the accuracy of K2, or the offset voltage, will be poor if 
W/4Sf becomes too much smaller than 2| K3| . The absolute value of K3 will become 
significantly negative as j W - X| approaches 32 x MAX. Therefore, the poorest ac- 
curacy occurs for small magnifications (large W - X) of the signal around zero. Be- 
cause of this, recorders having 1 volt as full scale should not be used directly by set- 
ting |X| at 10 times the desired value. Instead, a times-10 attenuator should be used 
ahead of the recorder . 


SAMPLE Subroutine Control 

The SAMPLE subroutine operates in a fashion similar to DATAO; that is, the 
main program and operating system determine when samples are taken, but what is 
sampled is controlled by the operator. The operator, however, can only select items 
for sampling that the system has stored in core; that is, he cannot control analog-to- 
digital converters or similar I/O devices. 

The command structure that controls SAMPLE is identical to that for DATAO. 

The SAMPLE control-command processor is entered from the normal INFORM 
control-edit command processor by using the < INFORM control-edit command. The 
program will return a < sign instead of the underscore to indicate a readiness to ac- 
cept SAMPLE control commands . A return from this routine to normal INFORM 
control-edit commands is accomplished using the underscore SAMPLE control com- 
mand. The SAMPLE control commands are listed in appendix E. 

Variables sampled by the SAMPLE subroutine are assigned channel numbers from 
0 to 79. Also assigned to each channel is a starting location for the core storage block 
to be used to save the samples for that channel. The length of the storage block is the 
same for all channels. This length must be set the first time the SAMPLE control- 
command processor is entered after a program load. The operator can accomplish 
this by using the B block- length definition command. (See appendix C . ) The operator 
must also convey to the program whether his system is programmed to use SAMPLE in 
the averaging or nonaveraging mode . He does this by using the B command and spec- 
ifying an averaging parameter in addition to the block storage length. If this averaging 
parameter is 0 or 1, SAMPLE will operate in the nonaveraging mode. If the system 
does use averaging, the operator must indicate the number of averages for each read- 
ing the system takes. 

Programmers will want to refer to the programming section for details on how to 
interface SAMPLE to his system and how an advanced system can automatically switch 
from averaging to nonaveraging operation or vice-versa, depending on the averaging 
parameter entered by the operator. 
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The operator is also responsible for defining the storage area for the samples. 

He must do this for each channel by using the A or C commands . The size of the 
storage area needed will depend on (1) the number of samples taken for each reading, 
(2) the system averaging mode, and (3) the number of channels defined (i.e. , the num- 
ber of named locations being sampled). Items (1) and (2) affect the block storage 
length that the operator should have defined with the previous B command. The block 
length should equal the number of samples per reading for nonaveraging and twice this 
number for averaging. 

For example, consider a system in which a reading consists of a single transient. 
If we wish to sample the transient data by taking 100 samples spaced 0.1 second apart, 
we would define a block length of 100 and the number of averages as zero. The 0.1- 
second spacing is beyond the control of the INFORM software, as this value would be 
determined by the system established by the programmer and the manner in which 
SAMPLE was called; that is, the system would have to provide independent means to 
initiate transients and change timing. 

If the system is intended for averaging operation and produces 16 identical tran- 
sients that are to be averaged to produce a mean transient, we must double the block 
length to 200 and define the number of averages as 16. The extra block length is 
needed by the program to store the 16 values received for each channel as a double- 
precision integer sum. 

The following is an example of how to define a SAMPLE channel for a transient 
that is to take 100 points of SPEED in a system not using averaging: 

< 

<B BLOCKJIZ-E.rJOO 

_#_AVERAGES_=_0 
<A 00__SPEED,' 40000, 40144 


Note that the B command is used to define a block size and number of averages before 
we proceed. If we decide to change these numbers at a later time, the B SAMPLE 
command will have to be reissued. This B command should not be used carelessly, 
however, since changing the block length may invalidate the starting storage location 
defined for the channels. Also, changing the number of averages may affect the $1 and 
$2 INFORM commands used to dump the sampled data. The user should carefully read 
the descriptions and warnings listed for this command in appendix E . 

To add more variables, say, ANGLE and TACH, to the list of SAMPLE channels, 
proceed as follows: 
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< 


40310 

'40454 


<A 01 ANGLE, s 

<A 02 TACH,, 


Note the good use of the starting storage location default option to keep track of stor- 
age. 

To repeat the above example for a system that uses averaging and repeats the 
transient 16 times, the procedure is 

< 

<b B L99L§I?§_r_ 200 

_#_AVERAGES_=_ 16 

<A 00 SPEED, 1 40000, ,__^40310 

<A 9!__ANGLE,,__:40620 
<A 02 TACH,, '41130 


Note that, since an average is being computed instead of a simple store, each sample 
requires two storage locations. We, therefore, defined the block size as 100 x 2 or 
200. The effect of the block length increase is seen whenever the program displays the 
next available location. These differences must be taken into account when using the 
B command to change block lengths and number of averages, as issuing the B com- 
mand will not automatically redefine the storage location of all channels . 


APPLICATIONS AND EXAMPLES 

Potential application for the INFORM software is limited only by the imagination 
of the user. The following simple example illustrates a typical manner in which 
INFORM is used. Assume that the system consists of an analog simulation of a motor 
and tachometer pair whose speed is controlled digitally by a 16-bit minicomputer. (A 
block diagram of the system is given in fig. 8, and the flow chart of the digital program 
is given in fig. 9. ) A dual-channel oscilloscope is included in the system to demon- 
strate the speed of execution of the program. By writing Dacs 1 and 2 to different 
levels at various points in the program, computer operation can be observed as it 
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Figure 8. - Motor/tachometer speed control system of example problem. 
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steps through a typical update cycle. Figure 10 shows a typical trace where DATAO 
and SAMPLE are setup for five channels. 

In this example, much of the INFORM software is exercised. Hence, in addition 
to acquainting new user’s with the program, this example can be used as a test proce- 
dure for those wishing to validate their software . To e limina te confusion, operator- 
entered carriage returns are shown herein as "j". The commands we will be using 
are listed in detail in appendixes C to E and are summarized in appendix I. 

The first step is to define the digital program variables. This is done using the 
INFORM space command: 

_ERR0R **'614,1 5000/32 768j 

_SETP **j 

_^000615 

_SPEED **,_!000616j 
_ITGRL **,_1000617,l/lB3j 
_V CMD **, .1000620, 10/lSj 


Notice that various default options have been used to indicate that ERROR, SETP, 
and SPEED have the same scale factor and are located in successive memory locations. 
Since these variables are in the common core and will not change as the program is up- 
dated, we have produced a binary-dump on the paper-tape unit (DF9) so that the next 
time the program is run the definition process will not have to be repeated. 

As a result of issuing the ! command, the paper tape was punched and the machine 
responded: 

VERI FY ?_ Yj 

We replied, "Y, " after mounting the tape just produced onto the paper tape reader 
(DF10). 

We should now like to observe the problem in operation. To do so, the strip-chart 
recorders will be used. Before they are used, they should be calibrated to operate be- 
tween 0 and 10 volts. To do this a calibration voltage is needed. There is no better 
source for such a voltage than the DATAO display system. In fact, if DATAO is used, 
the user need not remember that the system uses 0 and 10 volts, nor worry about Dac 
counts per volt, etc. He need only consider zero and full scale. To generate a cali- 
bration signal, dummy variable X is defined, and DATAO is set up to display X on 
all channels. By using the INFORM scale and store command, the value of X can be 
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changed and thus cause DATAO to generate a known display anywhere between zero and 
full scale. 

The procedure is as follows: Location '500 is unused by the program, so it can be 
used for X. 

_X **' 500,l/32000j 

Now set X = 0 . 

J^1999§oo_WAS=_N43772_o,Npw=_;ggggg 

Notice that we have chosen full scale of X = 1 to correspond to 32 000 counts. Using 
32 000 gives sufficient resolution in setting X (i.e., 1 part in 32 000), yet is not so 
large that 1 will not fit into our 16-bit machine (32767 being the maxi m um integer 
value). Any value could have been chosen, except that, if we had defined X as being 
1/1S, a problem would have arisen because IS does not fit the machine; that is, X 
would always have to be a fraction. Thus, an error message would be received if an 
attempt were made to set X = 1.0. 

The DATAO channels will now be defined. The Dac unit connected to the display 
is unit '60. 

>A 00_X,0,1 ,'60,10j 
>A gi_ ,0,1 , 1 60,11 j 
>A 02_,0,1 ,'60,12j 
>A g3_,0,1,'60,13j 
>A g4_,0,l,'60,14j 

We now adjust the recorder’s offset to display zero, then return to the INFORM com- 
mand mode so we can set it for full scale and adjust the recorder gain; 

.11 II 

_ _ J 

_x"_igog5gg_WAS=_^goooggp_i ,Ngw=_^g7§4gg 

The recorder's sensitivity is now adjusted to display full scale. 

With the calibration complete, the recorders can now be set up to display our 
problem. Using named locations, the variables SETP, ERROR, SPEED, ITGRL, and 
VCMD will be assigned to Dacs 10 to 14, respectively: 
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>@j 

>a go_SETP,ojooOj 
>A gi_ERROR,-l 000,1 OOOj 
>A g2_SPEED,0,1000j 
>A g3_ITGRL,-4,4j 
>A g4_VCMD,-5 ,5j 

>"_"j 

Note that typing has been saved by defaulting the Dac unit and Dac numbers. This can 
be done because these values were defined when the calibration procedure was per- 
formed. 

The first portion of figure 11 shows the resulting display. This display indicates 
that the system is unstable. Obviously, K4 and K5 were chosen poorly. The system 
should be stable. To locate the problem we will check K4 and K5 for proper scaling. 
They should be 3.0 and 2.0/3000.0, respectively. Since K4 and K5 are not in the 
common core, we will use the power of the sequentially formed arithmetic expression 
(SFAE) to define their addresses. To do this, the variable X is redefined as having 
the relocatable load address (’1045) of the control algorithm program. Then the as- 
sembly listing address of '100 for K4 can be used as follows: 

_X REDEF_'1045,0j 

_K4 **X+' 100,VCMD/ITGRL*1/lB4j 

_« 5 **,_^ggil 46_VCMD/ERR0R*1 /I B5j 

Since K5 follows K4, the K5 address was defaulted. Note also the fancy scale-factor 
manipulation used for K4 and K5 . Since K4 converts ITGRL scaling to VCMD scaling, 
VCMD/ITGRL (the ratio of the scale factors) was used in the scale-factor definition. 

To fit reasonable values of K4 into an integer value, it was necessary to further scale 
K4, hence, the factor 1/1B4. The program compensates for this additional scaling by 
an arithmetic left shift of four after the multiplication. (See the control equation in 
fig. 9, p. 29.) Similar reasoning applies to the K5 scale factor. 

We will now display K4 and K5. 

_K4=_igggg : 3 

K5= 66667-8 
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K4 ■ 10. 0 


K4 ■ 3.0 


Figure 11. 
system. 


Time, sec 

- DATAO traces for example problem showing effect of K4 change on 
K5 = 6. 667x10 . 






We had intended K4 to equal 3.0, but it must have been entered improperly when scal- 
ing K4 for the program’s data statement. The problem can easily be fixed by 

_ K4 "_199]I^_WAS=_^940099_3. 0 ,N0W=_;01 1463 

Figure 11 shows the result of this change. Notice that the control program keeps run- 
ning while we are making changes. 

The resulting system response is nice, but could be better. INFORM and DAT AO 
can be used to find more optimum values. Let's increase K5 by a factor of 10. 

_ k 5 ,, _:99!]46_ was =_;992999_ k 5* io . ,991^924999 

Notice how the SFAE simplifies increasing or decreasing by factors. The resultant 
trace is shown in figure 12 . It is now obvious that the scales for the SPEED (channel 2) 
and ITGRL (channel 3) traces can be expanded to make them readable . This is accom- 
plished as follows (with fig. 13 as the result): 

>C 02 , ,-500,500j 
>C 03, . 25 , .25j 

We will now get a listing of what the revised channel definitions are and save them 
by means of a relocatable binary-dump tape . The ? DAT AO command is used: 


>? lj 


00 

' 60 

10 

SETP 

00000 00 

10000-01 

01 

' 60 

11 

ERROR 

-10001-01 

10000-01 

02 

' 60 

12 

SPEED 

-50001-02 

50000-02 

03 

' 60 

13 

ITGRL 

-23001-05 

25000-05 

04 

' 60 

14 

VCMD 

00000 00 

10000-03 


VERIFY?_ y j 

*11 H 

> _ J 

The display for the channel definitions shows us first the channel number, then the 
DAC unit number, the DAC number, the named location, the EU value at 0 volt, and 
the EU value at 10 volts, respectively. 

Next INFORM is used to generate some steady-state data. First, a data table is 
built by 
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Time, sec 


Figure 12. - DATAO traces for example problem with K4 
and K5 optimized using INFORM. K4 = 3.0, K5 - 


Time, sec 


Figure 13. - Scale-expanded DATAO traces for example 
problem with K4 and K5 optimized using INFORM. 















_K4,_01 


K5- 02 

00 

_ERR0R, 

_01 

SETP, 

03 

_SPEED, 

03 

_ITGRL, 

04 

VCMD, 

05 


Jj 


The form command could now be used to print each update of the table as we 
change the set points that generate the steady-state data. However, to illustrate the 
passive mode use of the program, a different procedure will be followed. Set the op- 
erator's mode-select switch (sense switch H) for passive mode printouts. Note that 
the passive mode will not be entered until INFORM is left or a data table is printed 
(see fig. 6, p. 19). We will now set DFO through DF2 to set up the passive mode print- 
out to print data table 1 in format 2 on the line printer (unit 5): 

J 0,2j 
J Mj 
Jo 2 ,5j 

The table is started by printing the first point, complete with heading: 

-\ U, 5j 

Since the operator’s mode select switch was set for passive mode, the INFORM sub- 
routine was exited on completion of this printout. The system sense switch G is now 
used to control the entry of INFORM, since each time INFORM is entered a new lin e of 
data will be printed in the table . Before each printout, we will change the setpoint 
(SETP), then momentarily pulse sense-switch G to enter INFORM and print one data 
table line. Figure 14 is the result. 

The last line of the table reveals a serious problem: The steady-state error 
(ERROR) is excessively large. We will re-enter INFORM's interactive mode to exam- 
ine the problem. First, the operator's mode select switch is set to the interactive 
mode; then system sense switch G is reset to enter INFORM. 

Suspecting that the problem is caused by a temporary overflow when calculating 
VCMD, we will use INFORM's variable-trip-mode option to attempt to catch an over- 
flow just before it occurs . We will set the trip to occur when VCMD exceeds 9.8. 
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Figure 14. - Printouts produced for the example problem 
steady-state points generated by INFORM working in 
passive mode. 
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_[ VCMD>9. 8j 
HLT?_Nj 

Since the halt option has been declined, a printout of the data table will occur each time 
trip occurs . For readability we can print the heading on our table by setting DF1 for 
printout in format 1: 

Jo 1 ,1 J 

Now all we need do is exit INFORM to initiate the variable trip mode: 

_*J 

Note that system sense switch G must be kept on reset so that INFORM is entered 
repetitively. This is necessary so that INFORM can test each update cycle for the trip 
condition. After putting some disturbances into the system, figure 15 results. The 
system has been caught in a malfunction mode . A user could now use the halt option to 
stop the program; and then use INFORM or a suitable debug procedure to locate the 
defect. Stopping execution on the cycle that caused malfunction eliminates needless 
probing of cycles that operated correctly. 

Details of program repair are left to the reader. To terminate the variable trip 
mode, the operator's mode select switch is set to interactive mode. Once the under- 
score is obtained, the following command is issued: 

Jj 

To complete the exercise of the INFORM software, SAMPLE will be used to cap- 
ture a typical system transient. One hundred points will be collected for a single tran- 
sient; that is, the averaging mode will not be used. We now enter the SAMPLE com- 
mand processor: 

after which the first item should be to define the block size and number of averages: 

<Bj 

BL0CK_SIZE=_100j 

#_AVERAGES=_Oj 

Then, the channels are defined. Core starting from location '40000 will be used to 
save the samples: 
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K1 

ERROR 

K2 

SETP 

SPEED 

I TORI. 

VCMD 

29980-05 

10000-03 




10071-03 

14595 00 

14585 00 

32473—04 

98026—04 

K1 

K2 




ERROR 

SETP 

SPEED 

ITGRL. 

VCMD 

29980-05 

10000-03 




14923-02 

13593 00 

13444 00 

29946—04 

99728-04 

K1 

K2 




ERROR 

SETP 

SPEED 

ITGRL 

VCMD 

29980-05 

10000-03 




11219 06 

14149 00 

29306-01 

16887—04 

98558-04 

Figure 15. 
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Figure 16. - Display of data collected by subroutine SAMPLE. Display was 
produced using the INFORM "/" list core command. 
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<A 00_ERR0R, 1 40000, _^0401 44 
<A 01_SPEED,,_;0403]p 
<A p2_ITGRL,,_^p40454 
<A p3_VCMD 5> _^g4g620 

. II II 

1 _ J 

System sense switch A is used (fig. 9, p. 29) to start collecting data. Since the 
100-hertz system clock patched into interrupt level 2 is also the system update clock, 
a sample will be taken after each update cycle . It will then take 1 second to sample the 
100 points. We can use timing DAC2 to initiate a transient so that the disturbance can 
be synchronized with the samples . Since we do not want DAT AO to interfere with the 
taking of the samples (fig. 10), system sense switch B is reset to suppress the DATAO 
display. To display the data collected on the line printer (unit 5) do 

_$1 , ,5j 

_$2 , , 5 j 

However, as explained under the $1 and $2 command descriptions in appendix C, these 
printouts are not really intended for operator reading. (The $1 and $2 printouts are 
also shown in appendix C . ) The INFORM / list core command can be used to see the 
sampled data. To use this command to view the samples from SAMPLE channel 1, we 
first note that these samples start at location ’40144. If one forgets where the SPEED 
samples were stored, the ? display SAMPLE definitions command can be used to sup- 
ply this information: 

_>J 

§LgcK_sizf>_goiog 

# AVERAGES= 00001 


00 

ERROR 

'040000 

'040144 

01 

SPEED 

'040310 

'040310 

02 

ITGRL 

'040620 

'040454 

03 

VCMD 

' 041 1 30 

'040620 


Furthermore, it is usually desired to descale the values before they are listed. The 
SPEED scale factor should be used. Hence, the command issued is 

j ' 40144,' 40144+100,1 .SPEED, 5j 
The display is shown in figure 16. 
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Had we been using SAMPLE in the averaging mode, we would note that the data 
would be stored by SAMPLE as double-precision integers. Furthermore, it would 
represent the sum of the number of averages taken. Therefore, the number of aver- 
ages should be included in the scale factor to divide it out. For example, assuming 
that channel 1 starts at ’40310 and that 16 averages are taken, the command to dupli- 
cate the above printout would look like this: 

J ' 4031 0, ' 4031 0+200 ,6 , SPEED/1 6 , 5j 

PROGRAM STRUCTURE 

The program contains several subroutines that perform specific functions required 
by the various commands. Some of these subprograms are part of external supportive 
software packages required to implement the program. These external routines con- 
sist of floating-point arithmetic routines, I/O routines which input and display octal/ 
decimal or integer numbers and, I/O routines that produce and read relocatable binary- 
dump tapes. The math routines are usually supplied with most machines as part of the 
Fortran library. The special I/O routines are described in appendix F. 


INFORM Structure 

The program retains the information defining the named locations in parallel ta- 
bles. The table position of the named location in use by the command is called the 
"indexing variable. " This indexing variable is always maintained in the INDX location. 

The address of the named location is stored in the LOC table, and the name itself 
is stored in two tables called NAM1 and NAM2. The name consists of five, 6-bit trun- 
cated ASCII characters which constitute a 30-bit word length . The least significant 
16 bits are contained in NAM2, and the most significant 14 bits are in the least signifi- 
cant 14 bits of NAM1. The most significant two bits of NAM1 are maintained as zeros. 

The scale factor assigned to the named location is saved in table SF as a 31-bit, 
single-precision, floating-point, real value. The format used is consistent with the 
standard arithmetic software supplied with the SEL 81 OB computer on which this pro- 
gram was developed. To avoid the overflow and underflow problems of integer arith- 
metic, calculations which involve EU values are performed using floating-point, real- 
arithmetic software. 
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Information for the three different INFORM data-table sequences is stored in 
TAB1, TAB2, TAB3, and LGTH, where TAB1, TAB2, and TAB3 are format tables 
which correspond to data tables 1, 2, and 3, respectively. By being matrices of index- 
ing variables, they indicate which named locations are to be displayed and in what posi- 
tion. TAB1 is 100 locations long and can contain 200 indexing variables at two per 
word. TAB2 and TAB3 each contain 43 locations and can contain 86 indexing variables. 
An indexing variable of 255 (’377) denotes a line terminator for a line of the data table, 
and an indexing variable of zero indicates that a blank space is to be placed in the data 
table output. 

Operator errors are processed by branching to a common routine called EROR. 
This routine cancels the command in progress and returns to the beginning of the cur- 
rent command processor by using the RTRN location. RTRN contains a program ad- 
dress and is set at various places in the program to establish the point where this er- 
ror processor should return. RTRN also serves as the return address for the com- 
mand processing routines, thus making them independent of the command decode se- 
quence used to enter them. RTRN is set by executing a store place and branch (jump 
to subroutine) to RTRN followed by an immediate "branch indirect" to RTRN (return 
from subroutine) instruction. This method was used because it is the only way to save 
the program counter on the SEL 810B, a necessity when implementing a dynamic un- 
conditional jump instruction. The EROR and command processing routines then simply 
execute a branch to the address in RTRN. 


Program Flow Charts 

The structure of the INFORM software can be easily understood by referring to the 
flow charts of appendix G . Subroutines contained with the INFORM software have a 
separate section for their flow charts in this appendix. Descriptions of the functions 
of all the subroutines used are contained in appendix H. When subroutines are encoun- 
tered in program flow, a brief description of the essential functions being performed is 
given in the block to ease reading of the flow chart. It should be pointed out, however, 
that other essential functions may also be performed by the subroutines. The reader 
should refer to the particular subroutine flow chart to ascertain its complete operation. 
The variable arguments supplied to and received from a subroutine are shown in paren- 
theses by the ENTER and RETURN statements. The definition of these arguments is 
clearly spelled out within the subroutine flow chart. What these arguments are equiva- 
lent to for any particular use of a subroutine by a calling program should be clear from 
the statement of subroutine function in the calling program's flow chart. 
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Portions of the flow charts are contained within dashed blocks . An overall de- 
scription of what occurs within the dashed block is given at the point where the program 
flow initially enters the dashed block. Inside the block is more detailed information to 
aid an assembly-language programmer in achieving the required operation without vio- 
lating program conventions or assumptions. A quick overview of program operation 
can be obtained by only reading the descriptions for the dashed in blocks of the flow 
chart. 

The starting point for each command is located by finding the offpage connector 
symbol ( O ) containing the mnemonic listed under the Programmer' s Flow Chart Ref- 
erence section of each command description. The < and > commands of INFORM, 
however, are special, as they transfer the program to a different command interpreter 
section; that is, they change the value of the RTRN address so that when commands 
are completed, commands used to control the DATAO or SAMPLE subroutines and not 
INFORM's control-edit commands are expected. These two commands, taken together, 
may be treated as a completely different program that merely uses the INFORM- 
defined, named-location tables and some of the INFORM subroutines . This was done 
so that the program can be easily shortened by eliminating either SAMPLE, DATAO, 
or both, together with their somewhat common command processor. A more detailed 
description of this processor is given in the next section. 

This knowledge, together with the command and subroutine description sections 
should eliminate the need for any further explanation of the INFORM flow chart. The 
flow charts for the DATAO and SAMPLE subroutines and command processors (< and > 
commands) are listed in the final section of appendix G . 


DATAO and SAMPLE Command Processor 

DATAO and SAMPLE control commands are processed by a common command in- 
terpreter, the CMD subroutine. This routine interprets the command key character 
and branches to the appropriate command processing routine. The routines are com- 
mon for the @, C, D, *, !, and _ commands as only some operands differ. The ?, 

A, and B commands require separate processors, as the operations to be performed 
vary considerably. 

The ? and B commands are separated by having different returns from the CMD 
subroutine. Hence, the routines to process these commands occur under the SPL (< 
command) and ODAT (> command) INFORM command processing sequences because 
these sequences call the CMD subroutine. 

The "A" command has some processing functions in common for both DATAO and 
SAMPLE . The different portions are effected by having the common portion (the ADDO 
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processor) execute a dynamic jump to subroutine. This jump is changed when the op- 
erators for the common commands are changed in the SPL or ODAT sequences. The 
names given these dynamic operators are X01, DAI, NCH, CHIX, and NBUF. 


SAMPLE Structure 

The channel definitions for the SAMPLE program are stored in the TORG and SIDX 
matrices. The position of the values in these matrices is equal to the channel number 
they define. The matrix of indexing variables, SIDX, is used to obtain names and loca- 
tions of the variables sampled in a similar fashion as TAB1, TAB2, and TAB3 are used 
to obtain names and locations for INFORM data tables. The matrix TORG contains the 
starting addresses of the storage blocks used to save the samples. The operation of 
SAMPLE is straightforward and requires no further explanation. 


DATAO Structure 

The DATAO program is considerably more complex. As was done for SAMPLE 
and the data tables of INFORM, a matrix of indexing variables is saved in DIDX to 
point to the proper named locations for each channel. In order to produce an output, 
DATAO must make a calculation of the form 

Voltage output as a fraction of full scale = ^ ~ 

X 

where V is the current value in EU's, W is the EU value at the origin, and X is the 
EU value at full scale. It is this calculation plus the need for a fast output that causes 
the complexity. 

If the machine were to perform this calculation using software floating-point, real- 
arithmetic routines and the EU values at zero and full scale as supplied by the opera- 
tor, the calculation would take too long to be useful as a dynamic display. Therefore, 
this calculation must be translated into one composed solely of arithmetic, which can 
be speedily handled by the machine' s hardware . 

One might think that this is simply a matter of scaling the EU values and perform- 
ing integer arithmetic. However, this method creates problems because of possible 
subtraction overflows. Some sort of scaling would be necessary to prevent this. If 
this scaling had the effect of reducing the scaled magnitude of | X - W| , small values 
of | X - W| (corresponding to large magnifications of V), would produce inaccurate 
values because of the truncation of a small number to its nearest integer. This is sig- 
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nificant because it may be desirable to use DATAO to distinguish a changing bit pattern 
among a few least-significant bits of a large word. If this word represents something 
such as a program address, the scale factor will be unity, and |X - W | will surely be 
small. If the scaling were to increase the magnitude of | X - W| , a corresponding in- 
crease in the | V - Wj calculation would have to occur. But V is unknown, makin g 
it impossible to insure that the V - W calculation will not overflow without testing it. 

All this complication adds is unnecessary calculation time, for, if the required 
calculation is in the form 


Y = A x V + B 


A and B can be scaled such that proper operation will be assured if W and | X - W| 
meet modest requirements. The computation is performed as 


Y - 


V x K - + K2 
4 


2 K3 


The V xKl multiplication is done first to yield a 31-bit product. This is then 

shifted right by a full right arithmetic shift two places to divide by 4 . This shift will 

30 

also insure that the absolute value of the result is less than (1/4) x 2 .A double- 

30 

precision integer whose absolute value is less than (3/4) x 2 , K2, may then be added 

K3 

to the shifted product without fear of an overflow . The multiplication by 2 is then 
accomplished by means of a full right or left arithmetic shift, depending on a dynamic 
shift instruction that has been stored in the DEXP matrix. This shift instruction, or 
K3, is selected such that 2 ^ < | Kl] < 2^ 5 where K1 is an integer defined as 

Ki = ( l Q . v - 0 ^ 4xSf x2~ K3 
\ X - W / 


truncated to 16 bits. 

Then K2 becomes equal to -K1 xW/4Sf. If MAX is defined as the maximum 
scaled value of V that can be stored in a 16-bit word, the restrictions that | K3| be 
less than 16 (i.e. , a single shift instruction) and that K2 be less than (3/4)2 3 ® trans- 
late into 


< | W - X| < MAX x 2 5 

2 25 


and 


| W| < 3MAX 
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It is doubtful that it would ever be desired to exceed these bounds since they lie outside 
the possible values of V. 

The required coefficients of K1 and K2 are stored in the three matrices DK1, 

DK2, and DK2B. The shift instruction stored in the DEXP matrix is actually picked 
out of the matrix, stored in the program path, and executed for each channel. The out- 
put device number and Dac channel number are selected in a similar fashion by execut- 
ing an output instruction that was built by the machine at channel-definition time and 
stored in the DUNT and DCHN matrices. The details of this operation obviously depend 
on the I/O structure of the machine on which the program is to be run. 


PROGRAMMING NOTES 

An attempt has been made to divorce the flow chart from dependency on any par- 
ticular machine, yet retain sufficient detail to facilitate implementation on machines 
other than the SEL 810B. Since considerable programming effort and debugging time 
has gone into the program structure to make it both maintainable and free of unexpect- 
ed operations, it is highly recommended that those operations outlined in the flow chart 
be strictly adhered to . 


Handling of Input and Output 

It may be noted that many of the commands contain the capability to change the I/O 
device on which the input or display is to occur. This versatility is derived from the 
special I/O routines listed in appendix F. These routines are part of a CIPHER I/O 
library developed at Lewis, and are used for all input and output operations. They are 
designed to make all devices operate like a teletypewriter using an ASCII code. This 
capability was included since the required code is minimal because of the way that I/O 
devices are interfaced to the SEL 810B computer. Persons using machines with less 
capability may wish to delete the unit change option to possibly reduce the core require- 
ments of the I/O routines. Note however, that the I/O device independency does enable 
multiple use of each I/O routine and that the entire set of routines is thus very compact. 
Eliminating this device independency may so specialize the use of each routine that 
more routines will be required to perform the complete computing job. The additional 
routines may actually use more core than is saved. Since these routines are very ver- 
satile, it may be more beneficial to save core by applying these routines to tasks out- 
side of INFORM and tnus shorten the existing main program instead of vice-versa, 
stead of vice-versa. 
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Modifications to the INFORM program to accomplish this change are m inim al^ as 
all I/O device numbers are obtained through the UNIT subroutine and are thus easily 
identified for exclusion. To also ease the I/O change, the subroutine through which a 
particular I/O occurs is listed on the flow chart. 

The IN$ and OUT$ locations contain the device number to be used by the I/O sub- 
routines. They are kept pointing to the on-line keyboard by being frequently set to its 
device number. Those routines that might output through a modified IN$ or OUT$ unit 
number have all possible exits from these routines to points that reset IN$ and OUT$ 
to the operator's console. Since these exit points are not always easily identified, be- 
cause of intricate program interleaving, it is recommended that anyone wishing to 
change the I/O formats do so by making the I/O subroutines compatible with the pro- 
gram and not vice versa. Also, any required device switching should be done using 
IN$ and OUT$ as identified in the flow chart. 

Problems may arise when devices that need special commands to initialize them 
(such as, "top of form") are used. Since these functions could be performed manually 
for I/O devices on the development computer, no reference for performing these tasks 
is indicated. Since INFORM is an interactive program, it is extremely difficult to pre- 
dict the operator's intent when issuing each command. Hence, it is much easier to let 
the operator manually manipulate the I/O devices. If manual manipulation is impossi- 
ble, such as for magnetic tape, additional commands will be needed to allow the oper- 
ator to manipulate such devices. 

The program uses ASCII characters exclusively. In addition, inputs for which no 
reference to a CIPHER I/O library subroutine is given are done through the IOIN sub- 
program, which uses the INPT subroutine. The IOIN subprogram returns the ASCII 
code and filters out all ASCH codes used for control, such as rubout, line feed, XOFF, 
etc. , by not recognizing them as inputs. If the machine being used recognizes lower- 
case letters, IOIN should also convert such codes to caps. Thus, these codes are pre- 
vented from entering the program . This is an important consideration, since failure to 
filter these codes may bypass the normal error protection devices and thus cause un- 
predictable behavior. The INPT subroutine recognizes carriage returns, and forces a 
line feed if the input device is the operator's console. This is an important feature, 
necessary to prevent overprinting on the operator's console, because the INFORM soft- 
ware assumes that the operator's console is always ready to receive messages or start 
a new command line. Commands that are self -terminating supply their own carriage 
return line feed. 

Numerical Conventions 

All values used by the program are assumed to be integers unless they are repre- 
sented by AA, BB, CC, N, SVSF, VOLT, or numbers including a decimal point. The 
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AA, BB, etc., represent single-precision, floating-point real numbers . No mixed- 
mode arithmetic is shown, and all places where conversions are required are outlined 
explicitly . Places where double-precision integer arithmetic is required are also 
identified. Any integer arithmetic, when shown, should be easily performed on a 16- 
bit machine without overflows occurring. 

The author would like to caution programmers about converting floating-point val- 
ues to integer values. To maintain the operator's intent and the validity of commands 
by means of a maximum error recognition capability, it is important to cancel the in- 
struction in progress by a branch to EROR if the floating-point number to be converted 
is greater than the integer value the machine can handle . A classic example is when 
an overflow occurs when calculating an address. If the instruction proceeds with an 
invalid address, unpredictable operation may result. The C$21 routine supplied in 
most Fortran packages may be used only if it can be modified to return to EROR if this 
error is detected. 


Common Changes 

Modi fying the c ommand structure . - The filtering of ASCII control and lowercase 
codes from the input stream yields a particularly efficient method of performing the 
decoding of the command key character. All INFORM control-edit com ma nds are as- 
sumed to start with a name for a named location; hence, the NAME subprogram is exe- 
cuted first. When the return from NAME occurs, it is known that the six-bit truncated 
ASCII code for the command key character entered must be either 0 or '33 to '77 . The 
zero code is eliminated first by the machine's zero test. Of the codes remaining, if 
the code is less than '72, '25 is subtracted from it. If it is greater than or equal to 
'72, '72 is subtracted from it. The codes are thus translated into numbers 0 to '44. 
Numbers greater than '32 come from ASCII codes for numbers and may be eliminated. 
Hence, numbers less than '33 may be used as an index for an address array that con- 
tains the addresses of the start of the command processing routines. By executing an 
indexed, indirect-jump instruction on this address array (where the machine performs 
indexing before the indirect), a jump to the proper command sequence is effected using 
a minimum amount of the core for the decoding process. 

This procedure also makes it easy to add or drop commands by simply changing 
the address in the array. Key characters that have no corresponding command have 
the address of EROR in the array . The "#" should not be used for a command because 
the operator may confuse it with the "#" that terminates a command in progress. 

If more key characters are required, it is recommended that individual key char- 
acters be expanded into multiple commands by appending numerical character 0, 1, 2, 
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or 3, to the appropriate key character. This will create three commands where there 
was previously only one . This procedure was done for the : command, which became 
the four commands :0, :1, :2, and :3. This procedure is recommended because the 
routine to input and verify the numerals 0, 1, 2, 3 already exists with the program. 

By executing this routine followed by an indexed, indirect- jump instruction using the 
number input as an index, two additional commands will be decoded in less code than 
would be required to properly decode only one additional command using conventional 
compare and test procedures. This additional decode procedure is added to the start 
of the already existing command processing sequence (i.e. , processor CALC for the 
: command example) . 

Once one becomes familiar with the basic functions performed by the subroutines, 
adding commands to suit one's needs should be easily accomplished in a minimum of 
steps without having to seriously compromise the ideal command format or function. 
The possibility of taking portions of existing command processors and converting them 
to subroutines if portions of their functions are needed for new commands should not be 
overlooked. 

Changing defaults . - The initial values for the modifiable defaults DFO to DF12 are 
contained in an array called DFO. To permanently change the initial values of these 
defaults, simply change their initial values in the array. To add a modifiable default, 
simply add an initial value to the array and place the new length of the array in the 
DFMT data location contained at the end of the array. Likewise, to eliminate a default, 
shorten the array and change DFMT accordingly. Of course, the commands using the 
new or deleted defaults will have to be changed to accept or reject said defaults. The 
% change-default-value command will automatically adjust to the new array length, as 
it uses CFMT as a guide . 

Changing length of storage tables . - A common change to the program will be to 
shorten or expand the length of the storage tables. Given below are instructions on 
how to change the length of these tables. When making these changes, be sure to ob- 
serve any initial values as given in the definitions section. 

(1) To change the length of the defined named- location tables and thereby change 
the maximum number of named locations which may be defined 

(a) Set MAXL = X, the new length of these tables 

(b) Reserve locations for X values of matrices LOC, SF, NAM1, and NAM2. 

(Note: SF is floating-point real and requires two locations per value. ) 

(2) To change the length of data tables 1, 2, or 3, to X, Y, and Z, respectively, 

(a) Set the LIM matrix to LIM(l) = X, LIM(2) = Y, and LIM(3) = Z 

(b) Reserve X/2, Y/2, and Z/2 locations for TAB1, TAB2, and TAB3, re- 

spectively 

(c) Reserve the greater of X, Y, or Z locations for STOR. 
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(3) To change the maximum number of SAMPLE channels to X 

(a) Set NS = X 

(b) Reserve X locations for the TORG and SIDX matrices. 

(4) To change the ma xim um number of DATAO channels to X 

(a) Set ND = X 

(b) Reserve X locations for each of the following matrices: DKl, DEXP, 

DK2, DK2B, DIDX, DCHN, DUNT. 

If the passing of addresses to the PUNCH, LOAD, and VERIFY subroutines was 
properly programmed as being fully relocatable, changing the length of any of these 
tables will not affect the operation of commands that produce or load dump tapes. 
Likewise, all references to these tables should be independent of their length. 

It is for this reason, as well as for simplifying the logic that depends on the cur- 
rently used length of these tables, that all indexing is done in the forward direction 
(i.e. , the algebraic value of I + 1 is greater than I) using positive indices and that 
all loops are terminated by a compare-with-a-stop length. Failure to observe this 
convention may cause many errors and may actually make the implementation more 
complex. This is because the portion of these tables in use is constantly varying in 
length. In addition, most of the program operation depends on the value of the invari- 
ant indexing variables. Hence, much of the compare logic and indexing variable com- 
putations would need changing. It must be remembered that rolling of the defined 
named-location tables is not permitted, as this will change the indexing variables and 
thus alter the fundamental operation of the program. 

Core reduction . - A considerable reduction in the program core requirements can 
be made by eliminating the STOR temporary storage array. Its sole function is to in- 
crease the speed at which the values of the named locations are obtained. This is done 
to minimize data skew among variables that are not quite stationary because of noise . 
This problem is frequently encountered in on-line control systems where updating of 
the control calculation must be maintained on a priority basis while the INFORM dis- 
play is taking place. If this feature is not necessary, the STOR buffer can be elimi- 
nated with a corresponding change in the PTBL through EXIT portions of the flow chart. 

Some additional core (approximately 80 locations) can be saved by eliminating the 
default options of the commands . The savings come mainly from the elimination of the 
DFMT routine, the DFO array, and a shortening of each command in the appropriate 
manner. Some care will be required to eliminate this feature, however, and it is not 
recommended since it greatly improves program operation. 

Expansion to incorporate noninteger data types . - The elimination of the speed re- 
quirement will also simplify the expansion of the INFORM program to accommodate 
variables other than those stored as integers. The two most significant bits of the 
NAM1 location are free to contain a data-type code, say 00 for integer, 10 for double- 
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precision integer, 11 for floating-point, real numbers, etc. By creating a subroutine 
to obtain the current value of the variable and assuming that all values are floating- 
point numbers instead of integers, the modifications should reduce to a simple matter 
of converting all nonaddress arithmetic to that of floating point. Of course, the FIND 
subroutine would also have to be modified to ignore the first two bits of NAM1 when 
doing a search of the NAM1 and NAM2 tables. 

Expanding error messages . - Some persons may object to the ambiguity of the 
single ? error message issued whenever a fault is detected. Whenever a branch to 
EROR occurs, the flow chart lists an appropriate comment that explains the particular 
error occurring. To expand the message file, simply modify the error routine to ac- 
cept an argument to indicate which comment should be printed instead of the ? , and 
create a storage array of comments. The available assembly-language listing also 
has appropriate comments next to each branch to EROR. 


Distinguishing Averaging from Nonaveraging SAMPLE Mode 

The number-of-averages (NAVG) parameter entered by the operator is available 
from INFORM. It is an integer whose value may be obtained by the main calling pro- 
gram through external referencing procedures. It is greater than zero at all times. 

If SAMPLE is in the averaging mode, NAVG will be greater than 1 and equal to the 
number of averages. Hence, the calling program can use NAVG as the initial value 
for a do-loop that increases each time SAMPLE returns to the abort location, indi- 
cating that all sample points needed for a single average have been taken. The start 
of this loop should initiate or restart any required transients and initialize (re- 
initialize) the sample number argument of SAMPLE to zero. The operator will also 
require a sense switch or INFORM changeable, logical variable to indicate when to 
start the first average of a reading. This initialization is done by calling CLRSMP and 
setting the do-loop variable equal to NAVG. Figure 17 is the flow chart for such a 
system . 

If the main program is set up to handle averaging in this manner, it will automati- 
cally work when no averages are being taken, as NAVG will equal 1, indicating that 
only one pass through the do-loop should occur. 


CONCLUSIONS 

In this report a versatile program for generating and collecting data for display 
and information purposes has been described in detail. It has been shown that the 
software is sufficiently versatile to permit program debugging as well as to permit 
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" Uses an external reference to the NAVG INFORM variable. 

Figure 17. - Flow chart for automatic control of sampling when SAMPLE is operating in either the averaging or 
nonaveraging mode. 
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parameter optimization for software development. The fact that these manipulations 
may occur in a complete interactive or real-time environment increases the program' s 
power. The example problem barely taps the resources of the INFORM software. By 
using INFORM and becoming more familiar with the commands as outlined in appen- 
dices C, D, E, and I, the user should find many opportunities to benefit from it. In 
fact, users may find that they need never produce a program to perform man-machine 
communications again. 

Lewis Research Center, 

National Aeronautics and Space Administration, 

Cleveland, Ohio, March 26, 1979, 

505-05. 
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APPENDIX A 


A 

AA 

ACUM 


ADC 

ADDO 

ADDR 

ADD1 

Ad 

ANGLE 

AT 

ASCII 

ASNX 

AVLH 


B 

BB 


SYMBOLS 

mnemonic used to indicate single word or integer values held temporarily 
(usually in an accumulator) 

same as A, except represents double-word values such as numbers in 
floating-point- real format 

pointer indicating the next available location in the LOC, NAM1, NAM2, 
EXP and SF tables equal to the number of named locations defined plus 
one. Initial value; 1 + N, where N is the number of predefined named 
locations for the hardware registers 

analog-to-digital converter 

start of command processing routine that adds channel to DATAO or 
SAMPLE (See flow chart note 6, appendix G, p. 108.) 

address of defined name being tested for variable-trip-mode triggering 

start of the "add to data table" command 

octal-or-decimal address entered by operator (See appendix B for accept- 
able formats . ) 

dummy name operand used in examples 

start of the INFORM clear and open data-table command-processing 
routine 

american standard code for information interchange 

indexing variable to be assigned to the named- location definition being 
created 

latch to classify the current value of NAVG; equals -NAVG if and only if 
NAVG > 1, equals 1 if and only if NAVG = 1. If AVLH equals zero, it 
is an indication to the SAMPLE subroutine to store a value of zero in- 
stead of the normal value. Initial value: 1 

mnemonic used to indicate single word or integer values held temporarily 
(usually in an accumulator) 

same as B, except represents double-word values such as numbers in 
floating-point- real format 
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BUF 


CALC 

CD11 

CHIX 

CHNG 

CIPHER 

CLOP 

CMDC 

CMDS 

CNDF 

CR 

CRLF 

CRTB 

CTBL 

DAC 


Dac 

DACW 

DATA 


common core buffer used by NAME subprogram to store the name input 
in same format used by NAM1 and NAM2 tables . It contains all spaces 
if the name was defaulted. If the name contains less than three alpha- 
numeric characters, a space is added at the front. Initial value: un- 
specified 

start of the :1, :2, and :3 INFORM calculate-and-display command pro- 
cessing routines 

address pointer used by the INFORM list core command processing rou- 
tine. (See flow chart note 4.) 

equivalent to SIDX or DIDX (See flow chart note 5, appendix G, p. 107 . ) 

start of the command processing routine which changes a channel defini- 
tion of DATAO or SAMPLE (See flow chart note 6, appendix G, p. 108 . ) 

input /output library described in ref. 1 

flow chart connecting symbol 

channel incrementer for DATAO and SAMPLE A and C control com- 
mands; equals 1 for A commands and 0 for C commands 

start of the INFORM control command interpretation process 

number of modifiable defaults contained in the program 

ASCII code for carriage return 

used to designate ASCII codes for carriage return and line feed 

start of INFORM add name and/or start new line on open data -table com- 
mand processing routine 

start of the INFORM close or open data-table command processing 
routine 

direct-address constant equaling the starting address of a currently 
referenced data-table sequence array (TAB1, TAB2, or TAB3), with 
postindexing affixed 

digital-to-analog converter 

location in the DATAO subroutine where a dynamic output accumulator 
instruction is executed 

flow-chart symbol for portion of PTBL table printout routine where data 
are printed 
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DAI 

DCHN 

DEFN 

DEXP 

DFIX * 
DFMT 
DFX 
DFO 

DF1 

DF2 

DF3 

DF4 

DF5 

DF6 

DF7 

DF8 

DF9 

DFIO 

DF11 

DF12 


address to be used for the starting location of SAMPLE or DATAO mem- 
ory dump tapes (See flow chart note 6, appendix G, p. 108. ) 

matrix of digital-to-analog converter numbers on which DATAO outputs 
occur. Position in matrix corresponds to DATAO channel number. 
Initial value: zeros or some illegitimate converter number 

start of INFORM define-a-name or redefine-a-name command processing 
routine 

matrix of shift instructions for scaling DATAO outputs. Position in ma- 
trix corresponds to DATAO channel number 

temporary location used to save default indexing variable 
start of the set-default -forms command processing routine 
array of default values DFO to DF12 

number of format type to be used by passive-mode data-table printouts 
when the format specified in the calling program word (FORMAT) is 
zero 

table number to be used for passive-mode data-table printouts when the 
data-table number specified in the calling program word (FORMAT) is 
zero 

unit number to be used for passive-mode data-table printouts when the 
unit number specified in the calling program word (FORMAT) is zero 

default format type of INFORM print-data-table command 

default data-table number for INFORM print-data-table command 

default output unit number for INFORM print-data-table command 

default starting channel number for INFORM display-or-dump data col- 
lected by SAMPLE program command 

default ending channel number for INFORM display-or-dump data col- 
lected by SAMPLE program command 

default output unit number for INFORM display-or-dump data collected 
by SAMPLE program command 

default output unit number for saving definition dumps 

default input unit number for verifying or loading definition dumps 

default output unit number for INFORM list core command 

default output unit number for INFORM display all definitions command 


E-9810 
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DIDX 


DISP 

DK1 

DK2, 

DK2B 

DLM2 

DROP 

DTLH 



DUMP 

DUNT 


DU1 

EADR 

EQTY 


EQU 

EROR 

ERROR 


matrix of indexing variables to point to named location operand used by 
each channel of DATAO; order in the matrix corresponds to the DATAO 
channel number 

start of INFORM command processor to display single INFORM definition 

matrix of multipliers for scaling DATAO outputs. The position in the 
matrix corresponds to the DATAO channel number 

two parallel matrices representing a double-precision integer used for 
offset voltage calculations on DATAO outputs. The position in the ma- 
trix corresponds to the DATAO channel number. 

location where the command keyword or last operand delimiter is saved 

start of command processing routine that deletes a channel from DATAO 
or SAMPLE (See flow chart note 5, appendix G, p. 107 . ) 

data table latch. A negative number for DTLH indicates that no tables 
are open; 1, 2, or 3 indicates that that numbered data table is open. 
Initial value; -2 

start of INFORM display-or-dump data collected by SAMPLE command 
processing routine 

matrix of write-Dac-unit-number instruction on which DATAO Dacs 
(DCHN matrix) are located. Initial value; zeros or some illegitimate 
output unit coded instruction 

flow chart connector symbol 

last core address whose contents are listed by the INFORM list core 
command. Initial value; 0 

value used to implement dynamic compare logic required for variable- 
trip-mode operation. Value will usually be 0, 1, or 2, but the meaning 
may vary depending on the hardware compare instruction of the ma- 
chine used. For the SEL 810B; 0 means trip if the memory tested is 
greater than TRIP, 1 means trip if it equals TRIP, and 2 means trip if 
it is less than TRIP 

start of the INFORM command processor to display current EU values 

start of error processing routine 

name operand used in example problem; it represents the difference be- 
tween the commanded and measured SPEEDS . 
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EU 

EVT 

EXIT 

FMTY 

FMTO 

FORM 

FORMAT 


I 

ID 

IDXO 

INC1 

INC 2 


INDX 

INST 

IN$ 

I/O 
J, K 


engineering units 

start of the INFORM end-variable-trip-mode command processing routine 

program point where operator-set, mode-select flag is tested before re- 
turning from INFORM 

format type used by the INFORM list core command. Initial value: 0 

flow chart converting symbol directing start of routine to output a data 
table in format type 0 

start of the INFORM print-data-table command processing routine 

argument passed to INFORM to describe the format of the passive mode 
display. The least significant three bits are the output unit number; 
the next three are the data table number; and the remaining are the 
format type. A zero for any of these numbers implies the use of DFO, 
DF1, or DF2, respectively 

mnemonic used to indicate indexes and counters 

identification 

number of the SAMPLE or DATAO channel being defined or redefined 

number to be added to the potential default address for the DEFN INFORM 
command processor to determine the actual default address 

value to be added to ACUM when the named location definition is com- 
plete; equals 0 if and only if an old definition is being replaced, 1 if a 
new definition is in process 

current index used to reference the defined portion of the named-location 
definition tables LOC, SF, NAM1, and NAM2. INDX is referred to as 
the "indexing variable . " Initial value: 0 

machine-generated instruction for variable-trip-mode implementation. 

It is either a no-operation or stop instruction. 

pseudoregister or common-core location that contains the unit number of 
the current input device. IN$ is used by the CIPHER I/O library de- 
scribed in ref. 1. 

input or output 

mnemonic used to indicate indexes and counters 
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Kl, K2, j 

K5 J 
LGTH 

LIM 

LIST 

LOADS 

LOC 

LODO 

MAX 

MAXL 

Max 

Min 

N 

Na 

NAM1, 

NAM2, 

J 

NAVG 

NBUF 


constants 

three-word array containing the current length of data tables 1, 2, and 3. 
Initial values: LTGH(O) to LGTH(2), 0 

three-location data matrix used to indicate the maximum length the data- 
table sequence buffers TAB1, TAB2, and TAB3 may achieve. Values: 
172, 86, 86 

start of the INFORM list core command processing routine 

start of the INFORM restore INFORM definitions command processing 
routine 

matrix that contains the location for the definition of named locations. 
Initial values: LOC(O) = 0, the rest are arbitrary 

start of the command processing routine that loads channel-definition 
dump tapes for DATAO or SAMPLE (See flow chart note 6. ) 

maximum integer value the computer's arithmetic unit can process; 
usually equals +32767 (or -32768) for a 16-bit machine 

location containing the maximum length of the storage matrices for the 
definitions of the named locations 

operand for DATAO control command indicating the displays full-scale 
EU value 

operand for DATAO control co mm ands indicating the display' s minimum 
EU value 

memory locations where the floating-point- real-number input through the 
TYR subprogram is saved 

name operand (See appendix B for acceptable formats.) 

parallel tables that contain the five-character name for the definition of 
named-locations. Initial values: NAM1(0) = '20202, NAM2(0) = '4040 
(five spaces for the no-name parameter), and the remainder are arbi- 
trary 

number of points added together to implement the averaging filter of 
SAMPLE; must be greater than zero at all times. Initial value; 1 

maximum number of SAMPLE or DATAO channels that the ADDO com- 
mand processor will permit 
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NCH 

NDCH 

NGLH 

NLTH 

No 

NSCH 

ODAT 

OLDX 

OLSF 

OTBL 

OUT$ 

PCHO 

PTBL 

QURY 

QUTE 


equivalent to NSCH or NDCH. Used to indicate the size of the SAMPLE 
or DATAO channel storage tables. It also serves as the address used 
for the last location of the SAMPLE or DATAO memory dump tapes. 

(See flow chart notes 6 and 7 , appendix G, p. 108 . ) 

value in NDCH is one greater than the number of channels currently de- 
fined for DATAO . Initial value; 1 

latch used by subroutines MATH and NANU. If equal to -1, no negative 
sign preceded the name or number received from the operator 

name latch set by the NAME subprogram to indicate whether name was 
before the delimiter. Its value is -1 if and only if a name was entered. 
All other values imply no name was entered 

octal-or-decimal number used as operand (See appendix B for acceptable 
formats . ) 

one greater than the number of channels currently defined for SAMPLE. 
Initial value: 1 

start of the DATAO control command interpretation process 

old indexing variable, that is, the value of the indexing variable used by 
the last command. It is used by commands that permit a default of the 
name operand 

scale factor applied to number displayed by the list core INFORM com- 
mand. Initial value; 1.0 

start of the INFORM open-data-table command processing routine 

pseudoregister or common-core location that contains the number of the 
current output device. OUT$ is used by the CIPHER I/O library de- 
scribed in ref. 1 

start of the command processing routine that punches definition dump tapes 
for DATAO or SAMPLE . (See flow chart note 6, appendix G, p. 108.) 

start of the routine that prints a data table whose number is in TABN, on 
the device whose number is in OUT$, in the format contained in TFMT. 

start of INFORM command processing sequence to display all INFORM 
definitions 

start of the INFORM scale and store command processing sequence 
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RTRN 


SADR 

SF 


Sf 

SFAE 

SFTO 

SIDX 


SIZE 

SVLH 


SOUT 

SVSF 

TABN 

TAB1, ^1 
TAB2, > 
TAB 3 J 

TACH 

TADR 

TDKB 


return address for the EROR error processing subroutine, and for com- 
mand execution sequences. It points to one of three possible program 
locations: CMDS, SPL, and O DAT. Initial value: the address of 
CMDS 

first core address whose contents are listed by the INFORM list core 
command. Initial value: 0 

matrix that contains the first word of the single-precision, floating-point- 
real scale factor of the definition of the named locations. Initial values 
SF(0) = 0; the rest are arbitrary 

Scale factor 

sequentially formed arithmetic expression (See appendix B for acceptable 
formats . ) 

location in DAT AO where a dynamic shift instruction is executed 

matrix of indexing variables to point to the named- location operand used 
by each channel of SAMPLE . The order in the matrix corresponds to 
the SAMPLE channel number 

single value that equals the length of each SAMPLE storage block 

same as AVLH except that it is never zero . It is used to save the original 
value of AVLH when CLRSMP sets AVLH to zero. It is also used in- 
stead of AVLH whenever it is necessary to protect program operation 
from zero AVLH values. This is necessary since CLRSMP, DATAO, 
SAMPLE, and INFORM may be running concurrently on different inter- 
rupt levels. Initial value: 1 

flow chart connector symbol used to indicate exit from the VT routine 

scale factor obtained from the GSF or GSF2 subroutines floating-point- 
real value 

data-table number to be used by the PTBL data table printout routine 

matrices of indexing variables, which serve as format tables for data 
tables 1, 2, and 3. A value of *377 denotes a line terminator, and zero 
that a blank space is to be placed in the data table output 

dummy name operand used in examples 

address to be assigned to named location definition being created 

temporary location used to save value to go in DK2B matrix until all op- 
erator entries are received 
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TDK1 

TDK2 

TEX 

TFMT 

Tn 

TNA 

TORG 

TRIP 

TUN 

UARW 

VCMD 

VOLT 

VT 

VTLH 

X 

XOl 


temporary location used to save DK1 DATAO integer-multiply constant 
until all operator entries are received 

temporary location used to save value to go in DK2 matrix constant until 
all operator entries are received 

temporary location used to save shift instruction to go in DEXP matrix 
until all operator entries are received 

format to be used by the PTBL data table printout routine 

data table number operand 

two-location buffer that holds the packed name to be assigned to the 
named- location definition being created 

matrix of starting addresses of the sample storage block of each SAMPLE 
channel. The order in the matrix corresponds to the SAMPLE channel 
number 

scaled engineering unit value for the defined name being tested against 
variable-trip-mode requirements . TRIP is compared with the current 
value of the named location to determine if trip is to occur 

temporary location to save instruction to go into DO NT matrix until all 
operator entries are received 

start of the INFORM delete-data-table-line command processing routine 

name operand used in examples to represent a commanded output voltage 

floating-point real constant that equals the number of counts produced by 
the analog-to-digital converters for a 1.0- volt input. Value: 3200.0 
for the SEL 81 OB system 

start of the INFORM enable-variable-trip-mode command processing 
routine 

variable-trip-mode latch. A zero sets the latch that indicates that the 
variable-trip option is to be used when in passive mode. Initial value: 
Reset or not equal to zero 

used to represent single-word- variable arguments passed to or from sub- 
routines 

address pointer pointing to either the SI or Ol subroutines (See flow chart 
note 6, appendix G, p. 108.) 
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XX 


used to represent two-word-variable arguments passed to or from subroutines 
X2 flow chart connector symbol 

X3 flow chart connector symbol 

x used to represent an arbitrary ASCII character; may appear strung together, 

as xxxxx, to represent more than one (in this case, 5) ASCII characters 

Y used to represent single-word-variable arguments passed to or from subrou- 

tines 

Yn single ASCII character to indicate operator response; it is "Y" for yes, and 

"N" for no 

YY used to represent two-word-variable arguments passed to or from subroutines 
j symbol used to indicate an operator entered carriage- return 
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APPENDIX B 


CONVENTIONS AND DEFINITIONS 

Certain definitions and conventions are used when describing the operation of the 

program. These conventions are listed below. 

Values printed by the machine: When it is necessary for an example to indicate values 
printed by the machine, these values are underlined unless specified otherwise. 

Representation of ASCII or keyboard characters: Keyboard entries are shown within 
quotation marks. Where the character entered is nonprintable or ambiguous, such 
as "space", its description appears within the quotation marks. 

Representation of octal (base eight) numbers: Numbers displayed or entered in octal, 
or base eight, representation are preceded by an apostrophy. For example, '100 
is equivalent to decimal 64 . 

Machine size: Where references to machine registers are made or where maximum 
values or limits are given, they are for a 16-bit machine using two' s complement 
arithmetic and having a maximum integer capacity of +32767 and -32768. Single- 
precision, floating-point numbers are assumed to be 32 bit plus sign with a nine- 
bit, signed exponent field. 

Octal-decimal numbers: An octal-decimal number is any number entered in a format 
acceptable to the TTYR subroutine of the CIPHER I/O library. Acceptable formats 
are octal or free-format decimal. 

Octal numbers are preceded by an optional plus or minus sign followed by a 
mandatory apostrophy and must consist of one to six base-eight digits. Numerical 
length must not exceed 16 binary bits . The number is terminated with a comma or 
carriage-return . 

Decimal numbers may be optionally preceded by a plus or minus sign followed 
by any number of decimal digits. The decimal point may occur anywhere or be 
omitted. The absolute value of any entry must not exceed 10 . An exponent to 

represent either decimal, binary, or unity (scaled fraction) scaling may be entered. 
Decimal scaling is represented by an "E", ”E+", or "E-" entry followed by a max- 
imum of two decimal digits. Binary scaling is represented by a "B", "B+", or 
"B-" entry followed by a maximum of two decimal digits. Binary scaling is such 
that BO places the decimal point before the most significant bit of the machine’ s 
integer accumulator with B + I moving the decimal point right and B - I left I 
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places. Binary scaled numbers may not be converted to integers ynless X, the 
decimal numerical portion of the entry is 

-2 1 < X < 2 1 

Unity scaling is a special case of binary scaling equivalent to BO. All numbers 
are entered as fractions and scaled such that 1 . 0 is equal to the maximum integer 
value of the machine. To indicate unity scaling, an S follows the fractional entry. 
No digits are allowed after the S. The absolute value of a unity scaled value must 
be greater than or equal to -1.0 and less than +1.0. 

Numbers may be defaulted (omitted) by simply entering a comma (or carriage 
return if at end of line) . In this event the default value for the command in prog- 
ress will be used. An erroneous number may be deleted without canceling the 
whole command line by entering a rubout (ASCII '377) before the comma. The 
error message E! indicates that the start of a new number is expected. A comma 
immediately following the error message will result in the use of the default value. 
Entry of "8", "9", "B", "S", "E", or when entering an octal number or entry 
of an illegal sequence (i.e. , two exponents) will have the same effect as entering 
a rubout. Entry of any character not recognizable by the TTYR subroutine will be 
treated as a delimiter, thus causing a return to the INFORM software . Since 
INFORM only accepts commas, carriage returns, or spaces for delimiters, 
INFORM will cancel the command line and issue the error message ? when such 
entries occur. Examples for decimal 100. 0 are 


100, 100.0 1.0E2, +1.0E+2, 

+1 000E-1 , 1 000.0E-1 '144, 

n"rubout"_E^_ 100, 25B13 . 003051 76S 

For a -100.0 simply precede all the preceding examples by a minus sign. An en- 
try of '177634 is also equal to -100.0. 

Sequentially formed arithmetic expression (SFAE): A sequentially formed arithmetic 
expression is any string of octal or decimal numbers or defined names separated 
by +, -, *, or / characters. The sequence terminates with either a comma or 
carriage return, depending on the command using the SFAE as an operand. The 
numerical value to be used for a name also depends on the command using the 
SFAE. For example, when defining an address, the location of the named location 
as currently defined is used wherever the name appears. Other commands may 
use the currently defined scale factor or the current EU value of the named loca- 
tion. Appendixes C, D, and E list the default value appropriate for each command. 
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The SFAE is evaluated as each operation (+ for addition, - for subtraction, * for 
multiplication, / for division) and number or name is received. Once an operation 
is entered, it must be followed by a numerical value or name. Failure to do so, 
or use of an undefined name, causes the typout of ? and cancellation of the com- 
mand in progress. Assuming the values used for SPEED and TACH to be identical, 
some examples for the numerical value of 100 are 

1.0E2 1.0E+2 100, '144, ' 1 00+ 1 44 , 90+10, 

50*2, 200/2., 100.0*3.0/6.0*2.0, SPEED/TACH*! 00. , 

150+"rubout"_E! -50, 

Note: 50-50”rubout"_E^_+ 50, is incorrect since the rubout only cancels the octal 
or decimal number 50 and not the minus sign, which is a numerical operator of 
the SFAE indicating subtraction. The correct procedure would be to enter: 

50 — 50, as it is interpreted as 50-(-50), where the second minus sign is part of 
the octal or decimal number 50. 

Octal or decimal address: An octal or decimal address may consist of any sequentially 
formed arithmetic expression. If a name occurs within the expression, the loca- 
tion as currently defined for the named location is used as the numerical value. 

The comma or carriage return that terminates the SFAE also terminates the ad- 
dress entry. The only restriction on the SFAE is that the calculated value must 
be a legitimate core location. Warning : Since addresses are integers, intermedi- 
ate values formed when producing the SFAE that exceed 24 binary bits or that pro- 
duce fractions which cannot be represented exactly by a 32-bit floating-point quan- 
tity may result in calculated addresses that are incorrect due to truncation when 
the final value is converted to an integer. For example, 13/3*3 yields an address 
of 12 and not 13! Usually, one is safe if only addition, subtraction, and multiplica- 
tion by small integers are used when entering addresses. 

This flexibility in defining the address allows the rapid determination of ad- 
dresses that are located within arrays or relocatable subprograms, or both, and 
frees the operator from tedious base-eight or mixed-base calculations . By defin- 
ing named locations whose address is the relocation base of subprograms, the ad- 
dresses listed by the assembler may be used directly by simply inserting the de- 
fined name before the comma or carriage return terminating the SFAE. Examples 
for a decimal 100.0 address are given below. The named location "Na" is as- 
sumed to have a defined address of decimal 50. 

50+Na , Na+50. , Na+6"rubout"_E^_50, 

Na+Na, Na+'62, Na+1 00. -50. , Na*2 , 
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Scale factor (Sf ) : A scale factor (Sf ) is the number to be used to multiply by a machine- 
stored number to produce an engineering unit value. When being entered by the 
operator, it may consist of any sequentially formed arithmetic expression. If a 
defined name occurs within the expression, the scale factor as currently defined 
for the named location is used as the numerical value within the expression. The 
comma or carriage return that terminates the SFAE also terminates the scale- 
factor entry. A scale factor can be either positive or negative. A scale factor of 
zero is interpreted as being equal to 1.0, but that the named location represents 
an octal number rather than an EU quantity. For more information see the 
Defining named locations section (p. 16). 

NAME: A NAME consists of one to five characters for a named location. The first 
character must be one of the 26 possible alphabetic characters. Since truncated 
ASCII is used, all letters must be capitals. The remaining four characters are 
optional and may be any of the 36 possible alphanumeric characters. 
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APPENDIX C 


INFORM COMMANDS 

The general structure and use of the commands listed below is described in the 
section Use of Commands (p. 15). Unless the command has a prefix operand, the key 
character should be the first character on the command line. For commands with a 
prefix operand, the operand should precede the key character, since failure to do so 
will automatically substitute the default value for the prefix operand. The start of a 
command line is indicated by the machine output of an underscore and a bell. 

Any operand that appears within braces may be defaulted if the default value as 
listed for that operand is desired. Operands DFO to DF12 may have their default val- 
ues changed through use of the % command. Machine messages that occur as part of 
a command sequence are underlined and should not be entered by the operator . Al- 
though not shown, the operator may terminate formats with either a comma or a car- 
riage return. If a carriage return occurs before all operands are entered, the default 
value for the unentered operands is used. If an unentered operand has no default value, 
an error will occur. Some commands that have prefix operands (such as =) need no 
terminator, as they are terminated by the machine. A table containing a summary of 
all the commands is given in appendix I . 


Mode Control Commands 


Enable variable trip mode 


Key character 

Operands 

[ 

{Na}x{SFAE} 
HLT? Yn 


Na: A one- to five- character name for a named location. (See appendix B for ac- 
ceptable formats.) Default value: The last used name operand of previous 
commands . 

x: One of three possible characters (">", or "<") to indicate that the trip 

condition will be met when Na either is greater than, equal to, or less than 
the SFAE . 

SFAE : A sequentially formed arithmetic expression for an EU value for Na at 
which trip will occur. If a name appears within the SFAE, the current EU 
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value for that name is used as the numerical value within the SFAE . Default 
value: 0.0. 

Yn: One’of two possible characters - "Y" to indicate the desirability of a machine 
halt when the trip condition is met, or "N" to decline the halt option. 
Description: This command is used to set the variable-trip-mode latch (VTLH) and 
define the trip condition. Note: A mode change will not occur on executing this 
command, but the path of the passive mode will be altered (see section INFORM 
Mode Selection) . 

Programmer's flow-chart reference: VT. 


Reenable previous variable trip mode 


Key character 

Operands 

[ 

None 


Description: Envoking this command is the same as reentering the previous enable 
variable-trip-mode command as described above. If no previous enable variable- 
trip- mode command was issued, an error will occur. Variable-trip-mode condi- 
tions are not saved on relocatable binary dump tapes; hence, loading such tapes 
will not affect operation of this command. 

Programmer' s flow-chart reference : VT . 


Disable variable trip mode 


Key character 

Operands 

] 

None 


Description: This command resets the variable-trip-mode latch (VTLH). No operands 
are required. 

Programmer's flow-chart reference: EVT. 


Accept DATAO control commands 


Key character 

Operands 

> 

None 


Description: This command is used to change the input command string from INFORM 
control-edit commands to DATAO control commands. 

Programmer's flow-chart reference-. ODAT. 
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Accept SAMPLE control commands 


Key character 

Operands 

< 

None 


Description: This command is used to change the input command string from INFORM 
control-edit commands to SAMPLE control commands. 

Programmer’s flow-chart reference; SPL. 

Exit INFORM subroutine 


Key character 

Operands 


None 


Data Table Manipulation Commands 


Clear and open data table 


Key character 

Operands 

<? 

{Tn> 


Tn: A single-digit table number (1, 2, or 3). Default value: Data tablet. 
Description: This command clears data table number Tn and opens the table for en- 
tries to build a new table. 

Programmer's flow-chart reference: AT. 


Open data table 


Key character 

Operands 

( 

{Tn} 


Tn: A single-digit table number (1, 2, or 3). 
Description: This command opens table number Tn. 
Programmer's flow-chart reference: OTBL. 
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Close an open data table 


Key character 

Operands 

) 

None 


Description: This command closes any open data table. 
Programmer's flow-chart reference: CTBL. 


Add name to open table 


Prefix 

Key 

Addi tional 

operand 

character 

operands 

(Na> 

, None 


Na: A one- to five-character name for a named location. (See appendix B for 
acceptable formats. ) Default value: A blank space equal to the length of one 
variable printout is added to an open table. If no table is open, see "Descrip- 
tion" below. 

Description: This command adds the named location Na to the rear of an open table. 

If no table is open, no action is taken, but the name referenced becomes the de- 
fault value of the name operand for later commands that use the last-referenced 
name operand as their default value . If no name operand was entered, the default 
value remains unchanged. After the entry of this command, the machine prints a 
two-digit decimal number, indicating the number of entries since the last line ter- 
minator (i.e. , the number of names on the current line). 

Programmer' s flow-chart reference : ADD1 . 


Add name and/or start new line on open data table 


Prefix 

operand 

Key 

character 

Additional 

operands 

{Na} 

- 

None 


Na: A one- to five- character name for named location. (See appendix B for ac- 
ceptable formats. ) Default value: The line is terminated without adding a 
name to the table . 

Description: Variable Na, if supplied, and a line terminator are added to an open 
table . This will end the previous line of a currently open table and start a new 


72 



blank line . Following the entiy of this command, the machine will print a two- 
digit decimal number, 00, indicating the start of the new line. If no table is open, 
an error message is issued, and no action is taken. 

Programmer* s flow-chart reference: CRTB. 


Delete last line from open table 


Key character 

Operands 


None 


Description: This command is used to delete the last line of an open data table up to 
but not including the last line terminator in the table . If a line terminator was the 
last table entry, that line terminator as well as the entire previous line up to but 
not including the line immediately before the terminator is deleted from the table. 
If no table is open, an error message is issued, and no action is taken. 

Programmer's flow-chart reference; UARW. 


Print data table 


Key character 

Operands 

\ 

DF3 , DF4 


DF3: A format number (0, 1, 2, or 3). Default value: Format type 1. 

DF4: A data table number (1, 2, or 3). Default value: Data table 1. 

DF5: An octal or decimal number for an output device. Default value: Line 
printer (unit 5) . 

Description: This command is used to print the prestored data-table-sequence num- 
ber, DF4 (data table DF4) in data-table-format number DF3 on 1/O-device DF5, 
while in the interactive mode. Any combination of DF3, DF4, and DF5 is permit- 
ted, but care must be exercised to insure that data table DF4 has line terminators 
occurring sufficiently often to prevent truncation of a line by the I/O device. If 
data table DF4 is of zero length (i.e. , undefined), an error message is issued, and 
no action is taken. Examples of data formats 1, 2, and 3 are given in figure 7 
(p. 20). Data-table-format 0 is designed for computer to computer communica- 
tion. It is identical to a $2 SAMPLE-block-dump format for only one data block. 
The number of variables in the data table becomes the block-length number in 
this dump format. See the $2 command description below for a detailed descrip- 
tion of the $2 dump format . 

Programmer's flow-chart reference: FORM. 
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Miscellaneous Display Commands 


Display current EU value 


Prefix 

operand 

Key 

character 

Additi onal 
operands 

{Na} 

= 

None 


Na; A one- to five- character name for a named location. (See appendix B for ac- 
ceptable formats. ) Default value: The last-used name operand of previous 
commands . 

Description: This command is used to display the current EU value for the named 
location Na. 

Programmer’s flow-chart reference: EQU 


Calculate and display address 


Key character 

Operands 

:0 

SFAE 


SFAE: A sequentially formed arithmetic expression for an address. If a name 
appears within the SFAE, the address as currently defined for that name is 
used as the numerical value within the SFAE . 

Description: The octal representation of the value calculated by the SFAE is displayed 
on the operator's console. 

Programmer's flow-chart reference: CALC. 


Calculate and display scale factor 


Key character 

Operands 

:1 

SFAE 


SFAE: A sequentially formed arithmetic expression for a scale factor. If a name 
appears within the SFAE, the scale factor as currently defined for that name 
is used as the numerical value with the SFAE . 

Description: The value calculated by the SFAE is displayed on the operator's console. 
Progra mm er's flow-chart reference: CALC. 
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Calculate and display engineering units (EU) 


Key character 

Operands 

:2 

SFAE 


SFAE: A sequentially formed arithmetic expression for an EU value. If a name 
appears within the SFAE, the current EU value as located and descaled ac- 
cording to the name' s definition is used as the numerical value within the 
SFAE. 

Description: The value calculated by the SFAE is displayed on the operator's console. 
Programmer's flow-chart reference: CALC. 

Calculate and display octal words of floating-point EU value 


Key character 

Operands 

: 3 

SFAE 


SFAE: A sequentially formed arithmetic expression for an EU value. If a name 
appears within the SFAE, the current EU value as located and descaled ac- 
cording to the name' s definition is used as the numerical value within the 
SFAE. 

Description: This command is identical to the :2 command, except that the display 
consists of two octal values instead of the floating-point number. 

Programmer's flow-chart reference: CALC. 


List core 


Key character 

Operands 

/ 

{Adi },{Ad2} ,{x} ,{Sf} ,{DF11 } 


Adi: An SFAE for the starting octal or decimal address. (See appendix B for ac- 
ceptable formats. ) Default value: Last nondefaulted Adi used by this com- 
mand. Initial value; 0. 

Ad2; An SFAE for the ending octal or decimal address. Default value: Last non- 
defaulted Ad2 used by this command, if and only if Adi was defaulted. Ad2 
defaults to Adi if Adi was entered. Initial value: 0. 
x: Data or display type. This ASCII character should be "0" for an octal display 
of integer data: "1" for a decimal display of integer data: "2" for a floating- 
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■Hill 


point display of single-precision, floating-point real data; "4" for a decimal 
display of scaled-fraction data; "6" for a floating-point display of double- 
precision integer data; "7" for a decimal integer display of double-precision 
integer data; and "8" for an ASCII dump of core, the core being interpreted as 
containing 2 ASCII characters per word. Default value: Last nondefaulted x 
used by this command. Initial value: 0. 

Sf: An SFAE for an octal or decimal scale factor to be applied to the data. See 
appendix B for acceptable formats. Default value: Last nondefaulted Sf used 
by this command. The initial value assumed is 1.0. Note: This value is ig- 
nored for display formats 0, 7, and 8. 

DF11: Octal or decimal number for an output device. Default value; The opera- 
tor’s console (unit 1). 

Description: The core starting at location Adi and up to and including Ad2, is dis- 
played on the device selected by DF11. The value for x determines how the data 
are to be interpreted (integer, floating-point real, scaled fraction, or ASCII) and 
what kind of display is to be produced. Before the display, the data are multiplied 
by Sf. Sf is ignored for octal, double-precision integers, and ASCH data. 

Programmer's flow-chart reference: LIST. 


Data Storage Commands 


Scale and store integer 


P re fix 
operand 

Key 

character 

Addi tional 
operands 

{Na} 

II 

{SFAE} 


Na: A one- to five-character name for a named location. (See appendix B for ac- 
ceptable formats . ) Default value: The last-used name operand of previous 
commands . 

SFAE: A sequentially formed arithmetic expression for an EU value to be stored. 
If a name appears within the SFAE, the current EU value, as located and de- 
scaled from its definition, is used as the numerical value within the SFAE. 
Default value : 0.0. 

Description: The EU value as calculated by the SFAE is scaled and stored as an inte- 
ger using the scale factor and location of the definition for Na. The octal repre- 
sentation of the location for Na, which is to be modified, is displayed before ac- 
ceptance of the SFAE. The message issued is "LOCATION WAS = xxxxxx ". 
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After this message the operator should enter the SFAE. After the SFAE, the ma- 
chine will print the octal representation of the value just stored. The message is 
"NOW = xxxxxx". 

Programmer’ s flow-chart reference: QUTE. 


Commands for Definition Control 


Define a named location 


Prefi x 
operand 

Key 

character 

Additional 

operands 

{Na} 

"space" 

{Ad} ,{Sf} 


Na: A one- to five-character name for a named location. (See appendix B for ac- 
ceptable formats . ) Default value: the no-name parameter. 

Ad: An SFAE for an octal or decimal address. (See appendix B for acceptable 
formats. ) Default value: One greater than the address for that of the last- 
used name operand of previous commands . If Ad is defaulted, the machine 
will display the default value before accepting the Sf entry. (See note below. ) 
Sf: An SFAE for an octal or decimal scale factor. (See appendix B for acceptable 
formats. ) Default value: The same scale factor as that of the last-used name 
operand of previous commands . 

Note; If Na is defaulted, the no-name parameter becomes the default name operand 
for following commands. For example, 

space" **1 ,0 
_=_^ 000000 

The "=" command displays the no-name parameter (i.e., core location 1) using a 
scale factor of 0 . Continuing, 

_SPEED" space" **,_^000002 , 

Since we defaulted both Ad and Sf for the space command, a value of 1 + 1, or 2, 
became the default location (as demonstrated by the machine display of ’000002). 
The default Sf became 0, since the definition for the no-name parameter we just 
defined was used to determine the Ad and Sf values. 

Description: This command is used when it is desired to define a named location. The 
default option for Na, or the no-name parameter, is especially useful when making 
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program patches or doing random searches during debugging. It allows the oper- 
ator to manipulate the core with all the power associated with named variables, 
but without cluttering the defined-name list with temporary definitions . The no- 
name variable is overwritten each time this command is envoked, but the ensuing 
definition is used to determine the default values of subsequent commands; that is, 
the no-name parameter becomes the last-used name operand for these commands 
until a predefined name is used. The use of this command to make program 
patches is illustrated by the following sequence used to patch machine instructions 
in locations ’400 through *405. 

space" **'400,0 

y^s_ =_ ^ ooooo o_ ' 22 >_now_=_^oooo 22 

_ ,, space ,, **,_iggg401_, 

_"_1999!91_wA§_r_loggog]_'o32404,_Ngw_=_^g324g4 

_ ,, space ,, **,_^ggg4g2_, 

J , _!9994g2_wAs_=_H;ngig _ 1 1 0405 ,_Ngw_=_;gi g4g§ 

_ ,, space ,, **,_;ggg4g3_, 
space 11 **,_^ggg4g4_, 

_=_;gg_7776 

_"s pace" **»_10ggfg§_ 1/32768 
_"_!999495_WAs_=_n23456_o.5,_Ngw_=_^g4gggg 

Programmer’s flow-chart reference: DEFN. 

Redefine a named location 


Prefix 

operand 

Key 

character 

Additional 

operands 

{Na} 

"space" 

{xxxxx}, {Ad}, {Sf} 


Na; A one- to five- character name for a named location. (See appendix B for ac- 
ceptable formats . ) 

xxxxx: A one- to five- character name for a named location to replace name Na. 

It (i.e. , xxxxx) may be the same as Na but otherwise must be unique. (See 
appendix B for acceptable formats. ) Default value: The name used for Na 
(i.e. , the name stays the same). 
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Ad: An SFAE for an octal or decimal address. (See appendix B for acceptable 
formats.) Default value: The address currently defined for Na (i.e., the ad- 
dress remains unchanged). 

Sf : An SFAE for an octal or decimal scale factor. (See appendix B for acceptable 
formats.) Default value: The scale factor currently defined for Na (i.e., Sf 
will remain unchanged). 

Description: This command is used to redefine a named location. All occurrences of 
variable Na in any tables will now be replaced with variable xxxxx, and the new 
location and scale factor, as defined, will be used. The only exception to this rule 
is when Na occurs in a DAT AO table. Here, the new name and location will be 
used, but because additional values are derived from the scale factor when build- 
ing DAT AO tables, the old scaling for Na will be applied to xxxxx in DATAO out- 
puts. Hence, the DATAO table entry must be re-entered. (See appendix D for 
commands to revise the DATAO tables.) 

Programmer' s flow-chart reference: DEFN(OVLY). 


Change a default value 


Key character 

Operands 

% 

DFn, {No} 


DFn: Integer number of the default value to be changed, that is, "0" for DFO, "1" 
for DF1, etc. 

No: Positive octal or decimal number of the value to which the default is to be 
changed. Default value: The current value remains unchanged and is dis- 
played on the operator's console. 

Description: Default values for commands that are given numbers such as DF1, 

DF2, . . ., DF12 can be changed using this command. INFORM definition dump 
tapes will automatically contain the modified defaults. All default values must be 
positive integers. The machine will display the current status of any default value 
if No is defaulted. 

Programmer's flow-chart reference: DFMT. 


Display all INFORM definitions 


Key character 

Operands 

? 

{DF1 2} 
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DF12: Output device number. Default value: Line printer (unit 5). 

Description: The location and scale factor for each named location currently defined 
is displayed on output device DF12. Since users may define their scale factors as 
ratios, the single numerical value of the ratio may be of little concern; hence, an 
EU value corresponding to the maximum value a single integer can contain and the 
EU value corresponding to a 1-volt Dac output are also displayed. Each definition 
is numbered so that the operator can determine how many definitions remain be- 
fore the name learing tables are filled. 

Programmer’s flow-chart reference: QURY. 


Display a single INFORM definition 


Key character 

Operands 

& 

{Nal 


Na: A one- to five-character name for a named location. (See appendix B for ac- 
ceptable formats. ) Default value; The no-name parameter. 

Description: The location and scale factor as currently defined for named-location Na 
is displayed on the operator's console. An Eu value corresponding to the maxi- 
mum value a single integer can contain and the EU value corresponding to a 1-volt 
Dac output are also displayed. The indexing variable for the name is also dis- 
played preceding these numbers . 

Programmer’s flow-chart reference: DISP. 


Save INFORM definitions 


Key character 

Operands 

! 

{DF9} 

VERIFY? Yn ,{DF10} 


DF9: The unit number of the output device on which the dump is to occur. Note: 
Either a comma or carriage return may follow DF9. Default value: Paper 
tape punch (unit 2). 

Yn: A single ASCII character, "Y" or "N", to indicate if the dump just produced 
is to be verified. 

DF10: The unit number of the input device from which the dump is to be read. 
DF10 should only be entered if Yn is the ASCII "Y". Default value: Paper 
tape reader (unit 2). 
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Description: All the defined named-location definitions, the three prestored data-table 
sequences, and the default forms are output on device DF9 in a relocatable binary- 
dump format. This dump may be saved and used to restore these operator-defined 
values at a later date by using the * (restore definitions) command. The VERIFY? 
query occurs after completion of the dump. If it is desired to check the dump for 
bit errors, the dump should first be mounted onto device DF10, then an ASCII "Y" 
should be entered for the Yn mnemonic, followed by a value for DF10 . The dump 
will then be read and checked against the values in core. If and only if an error 
occurs, CK is printed on the operator's input device, and the command is termi- 
nated before the- entire dump is read. If no verification is desired, an ASCII H N" 
should be entered for the Yn mnemonic, and no DF10 should be entered. This op- 
tion is especially useful when INFORM is used for programs that have their named 
locations defined as being in the common core . The program may be updated and 
reloaded without having to redefine the INFORM names. As long as the common 
locations remain fixed, the dump tape may be used to teach a new load the old 
definitions . 

Programmer's flow-chart reference: PNCH. 


Restore INFORM definitions 


Key character 

Operands 

* 

{DFIO} 


DF10: The unit number of the input device from which the definition dump is to be 
read. Default value: Paper tape reader (unit 2). 

Description: A dump produced by the ! (save definitions) command is read from device 
DFIO. The values read from this dump replace those values and become the cur- 
rently defined values. As a result of executing this command, all tables are 
closed and the variable-trip mode is disabled. If a read error occurs during the 
load process, CK is printed on the operator's input device, all table sequences, 
definitions, and default values are cleared to their initial values, and the command 
is terminated before the remainder of the dump is read. Since all program intel- 
ligence is lost if a bad dump is read, it is good practice to verify all dumps before 
using them. 

Note; If, after a fresh load of INFORM, a dump is produced before any definitions are 
made, this dump will clear the program memory whenever loaded. Loading this 
dump will allow the operator to start with a fresh set of definitions whenever 
desired. 

Programmer's flow-chart reference: LOADS. 
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Display /Dump Data Collected by SAMPLE 


Output SAMPLE channels in format type 1 


Key character 

Operands 

$1 

{DF6} ,{DF7} ,{DF8} 


DF6: An octal or decimal number representing the first channel data block to be 
output. Default value: zero. 

DF7: An octal or decimal number representing the last channel data block to be 
output. Default value: 80. Note; If DF7 exceeds the number of channels cur- 
rently defined, only as many channels as are defined will be dumped. 

DF8: Number of the output device on which the data from the SAMPLE subroutine 
channels is to be output. Default value: Floppy disk (unit 3). 

Description: The data gathered by the SAMPLE subroutine for channels DF6 to DF7 is 
output on device DF8. If DF7 exceeds the number of channels currently defined, 
the last channel number defined is used for DF7 . The data are taken from the 
storage blocks reserved for the SAMPLE channels . The entire block length, as 
currently defined, is output for each channel. If averages were taken, only the 
single-precision value of the average is output. The data for each channel are out- 
put in ASCII characters representing the decimal equivalent of the scaled binary 
data. Each line of output is terminated with the carriage return, line feed, and 
"XOFF" (ASCII *223) characters. This format was established for automated read- 
ing of the output into a larger time- sharing computer system using a Fortran pro- 
gram. A typical $1 dump is shown in figure 18. 

The data are grouped in blocks of lines, one block for each SAMPLE channel . 
Preceding all of these blocks are three lines: The first line contains the number 
of data points within each block of data that is to follow. This number occurs 
twice in the Fortran format of 216. The second line of output is a number de- 
rived by multiplying the first channel number by 100 and adding the last channel 
number. This value occurs in the Fortran format of 16. The third line duplicates 
this number in the Fortran format of 18. The data blocks follow these three lines. 
The format for each line within a channel’s data block is as follows: 

First line: The channel number occurs twice in the Fortran format of 216. 
Second line: The scale factor of the named- location sampled for this channel 
appears. The scale factor is in the Fortran format of 16, 13, where the 13 value 
represents a power of 10 to be multiplied times the 16 value. 

Third line: A checksum in the Fortran format of 17 is given. This value 
equals the algebraic sum of the 16 and 13 values of the second line above. 
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001 610 @8,1 t'lti 

00603 

0000003 

06000 06000 

45776—8!... 

040771 

-08172-081 98- 
-00372-68366- 
— 01 88/8—6 6 8 00- 
00.1.72 06106 
00380 06380 
00970 00897 
£106456 
00001 00001 
45776-05 
045771 
02166 02:197’ 
0236*6 07364 
01504 01478 
06506 00472 
00244 60242 
01024 0:1:167 

01 3484 

00002 00002 
24414-08 
024406 
02324 02299 
0:1.592 01546 

-00653— 80753- 
-01295-01276- 
-00603-00556- 
01592 01 703 
019841 
00003 00003 
30518-08 
030510 
04717 04527 
61960 01 888 
-85958-85888- 
-02498-02283- 
66452 00565 
68670 08547 
079832 


•80277-00744- 
•00366-00366- 
■0(0728— 00656- 
00:1 82 087:1 4 
t'i Ifi Y !“• fe'i If.'* ’£ V 
0081 6 06747 


072:1 8 07748 
02! <60 0231 i*4 
81 31 .4 61 vm 
004 17 00414 
06748 60756 
6:1 :1 78 0:1 757’ 


82271 07748 
01506 81455 
■00844-88926- 
■8:1/54-01.728- 
■00589-80467- 
01805 61897 


843-1 8 841 55 
81 769 0:1 691 
■05666-05503- 
■07:1 80-01 878- 
80658 8877:1 
084 1:1 88767 


00. ■' c 1 4 - i-'i i:i . *:■ i . •: L i r. — : ■ i* I . .1 6— 00.<87— 00340— 00348— 00356.— 00366*— 00368— 003^8— 80374— 08374— 08374— 005610 

•00356— 00348-66338— 61 ,'08-0:1 666-61602-01 522-01442-01362-01278-01196-01114-01034-08956-017378 
•60586-00!: i23-0!.i4:. ..'■-( 4 :. ::- | 6-80226-86278-00777-001 72-00120-00072-00630 80014 60852 06692-006094 
08240 00267 002. 32 08300 00314 80336 88342 86352 60364 06370 80372 00380 80380 00380 005342 
08370 8O.-.V0 00.-04 60358 81712 81678 81614 01538 61460 01374 81292 01210 61128 01046 617626 

i’‘ , 4 li'Nf’i *T' I;'. 1 1 t'ii; 


L-V'767 8. 85 ■:t:6 .-■’.•< J 2 02374 02:336. 03' .3-44 142357 03' 3 6*0 02:362 02:366 82:3661 02:368 82:368 041520 

62350 87344 6, ■.■■'336 67378 02794 62728 62150 07068 81.996 01984 01822 01740 61660 01582 838246 

6:1 7.1 4 0j. :1 4t* 6:1 66:7' 01 87' 7' 86962' 08904 88848 86794 80746 00786 006.56 00611.2 00574 00534 01 7 364 

06306. 00366 175346. 083:76. 8831 0 6 6 7' 9 4 082*84 06774 86764 08256 801252 0012:48 0101246 00244 005930 

0(1704 00, -i 1 6. 010126.3 0 -. ■ - ' 77; 68/78 0101312 80i3?*8 80454 016534 fei66,18 087012 60784 808616 06948 867960 


6:1327 fel l .<97 61468 01 576 01584 01644 


077017 87171 87.1 37 07091- 0170501 87887 81963 81918 01.872 01826 01/80 81733 01686 81639 036210 
61 41 0 01 366 01 525 011 1 1 0 801901 00708 00509 08378 001 57-00803-081 53-88293-06423-00543 012482 
•01 8001-0.1 86.6-011 1 73-81 1 73-81 si 5-01 11.8-81 778-8.1 300-01 315-01324-01328-01327-01321-01310-020506 
•01 1 98-0:1 1 66—0.1 1 3J -01 894-01:1 055-01 01 4-00977-08928-00883-00837-00791-00/44-00697-00650-018213 
■010141 6-6te»/l.i -0i032'5— 067.81 -0066? 01011 42 801343 01853:5 08?'17' 010:388 01849 81286 011341 011471 004097 
01981 8/0! >6 07177 07:1801 07731 62274 


03976. 8: :7?0i 0i.--.58t-. 63448 013259 83116 82971 82823 07662 02542 02431 02289 02176 02063 858843 
8:1 6.013 01.1 5 .< 5 81 40-:!.'— 0i!.>80 0i6J 66:— 863(3:1 — 016-389— 0i6-423<— 016434— 863(98— 063(48— 86274— 016186— 060184— 015.6946 
05 550i — 051 0.9 — 0:49 f 6> — 04 .■ ‘96. — 04!_.96. — 014390 — 0.4:1 r"8 — 01.(96:01 — 03 .■ !_*6> — 0i 3:55 8 — 03338 — 031. 15. — 6129-1 1 — 012684 — 079692 
•01 676-(il 489-111 305-81 .1 76-610967-00784-00673-00468-00300-08159-00839 081.14 08227 00348-017009 
8885.1 6i09c-2 ti.1048 6H 111. 88399 08738 88895 08973 89628 89881 88977 08929 68858 88768 094954 
08.174 8, <944 87762 8756:1 017404 87287 


Figure 18. - Display of data collected by subroutine SAMPLE. Display was produced using INFORM $/ command. System of example problem 
was used to obtain data. 
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Fourth line: The fourth through the next to the last line of the data block con- 
tain the scaled data. Each line consists of 18 data points plus a checksum. The 
Fortran format is 1816, 17 . The checksum in format 17 represents the algebraic 
sum of the 18 16 values. 

Ndxt to last line of block: If less than 18 values remain to complete the num- 
ber of points in the block, only as many 16 values as are needed are present, and 
no checksum appears on this line. 

Last line of block: This line is the checksum in the Fortran format of 17 for 
the short line produced above . If the number of points in the block is an integer 
multiple of 18, no short line was produced above, hence the checksum appears on 
the line with the data and this line is omitted. 

Note: EU values are obtained by multiplying the data that start on the third line by the 
scale factor derived from the first line. 

Programmer's flow-chart reference: DUMP. 


Output SAMPLE channels in format type 2 


Key character 

Operands 

$2 

{DF6} ,{DF7} ,{DF8} 

.... . . — 


DF6: An octal or decimal number representing the first channel data block to be 
output. Default value: zero. 

DF7: An octal or decimal number representing the last channel to be output. 
Default value: 80. Note; If DF7 exceeds the number of channels currently 
defined, only as many channels as are defined will be dumped. 

DF8: Number of the output device on which the data from the SAMPLE subroutine 
channels are to be output. Default value; Floppy disk (unit 3). 

Description: This command is similar to the $1 command except that the data are de- 
scaled by multiplying by the scale factor for the named location associated with the 
SAMPLE-channel number. The product is a floating-point number. A typical $2 
dump is shown in figure 19. The format for each line within a channel's data block 
differs from that for a $1 dump. It is as follows: 

First line; The first through next to the last line of the data block contains the 
scaled data. Each line consists of 12 data points plus a checksum. The Fortran 
format is 12(16, 13), 18. The 13 value represents a power of 10 to which the 16 value 
should be raised to obtain the EU data value; that is, -100.0 would appear as 
-10000-02. The checksum in format 18 represents the algebraic sum of the 12 16 
values plus the 12 13 values. 
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Figure 19. - Display of data collected by subroutine SAMPLE. Display was produced using INFORM $2 command 
was used to collect data. 


1 0931.-02-1 6297-02-0307471 
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12080-02 1171.9-02 0181342' 
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2.0610-00 29297— 00— 0039304 
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■1.8879-04-1.8568-04-0164922 
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24792-84 24243-04 0310817 


System of example problem 



Next to last line of block: If less than 12 values remain to complete the num- 
ber of points in the block, only as many 16/13 pairs as are needed are present, and 
no checksum appears on this line . 

Last line of block: This line is the checksum in the Fortran format of 18 for 
the short line produced above . If the number of points in the block is an integer 
multiple of 12, no short line was produced above; hence, the checksum appears on 
the line with the data, and this line is omitted. 

Programmer's flow-chart reference: DUMP. 
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APPENDIX D 


COMMANDS TO CONTROL THE DATAO SUBROUTINE 

Displays from the DATAO subroutine are referenced by channel number. The 24 
channels available are labeled 0 to 23. Assigned to each channel is a single named lo- 
cation, two EU values representing zero and full-scale outputs, an output-unit number, 
and a Dac channel number for the output unit. These values for each channel must be 
defined by the operator before a display of that channel will occur. Only unit and chan- 
nel numbers corresponding to system Dacs are accepted. Channel numbers must be 
defined sequentially, but once defined may be modified, but not deleted, at any time. 
Only the highest number channel may be deleted. 

The DATAO control command processor is entered by using the > INFORM 
control-edit command. The computer returns a > sign instead of the underscore when 
the DATAO control command processor is in effect. The DATAO control commands 
are listed in this appendix. The underscore DATAO command will return control to 
the INFORM control-edit command processor. 

Add a new channel definition 


Key character 

Operands 

A 

{Na},SFAE1 ,SFAF2 ,{Dn} ,{Dnn) 


Na: A one- to five-character name for a named location. See appendix B for ac- 
ceptable formats . Default value: The last-used name operand of previous 
commands . 

SFAE1: An SFAE for an EU value to represent the 0-volt output of the display. If 
a name occurs within the SFAE, the current EU value as located and descaled 
from the named- location definition is used as the numerical value within the 
SFAE. 

SFAE2: An SFAE for an EU value to represent the 10-volt output of the display. 

If a name occurs within the SFAE, the current EU value, as located and de- 
scaled from the named location definition, is used as the numerical value 
within the SFAE . 

Dn: An octal or decimal unit number for one of the Dac units. Default value: The 
last value of Dn used for this DATAO channel . Channels that have not been 
previously defined since program load will generate an error if Dn is de- 
faulted. The DATAO @ command does not destroy this default value. 
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Dnn: An octal or decimal Dac number of unit Dn. Default value: The last value of 
Dnn used for this DAT AO channel. Channels that have not been previously de- 
fined since program load will generate an error if Dnn is defaulted. The 
DAT AO @ command does not destroy this default value. 

Description: The next sequential DATAO channel number supplied by the machine is 
defined to display the value of Na on a linear scale, outputing 0 volt when Na = 
SFAE1 and 10 volts when Na = SFAE 2. The channel number being defined is dis- 
played by the machine immediately after the delimiter that separates the ’’A” key- 
word from the operands. To protect recording equipment, the program limits the 
output to the -0.1 and 10.24 volt levels. No restrictions exist on the relationship 
of SFAE1 to SFAE2; that is, SFAE1 may be less than, greater than, or equal to 
SFAE2. SFAE1 and SFAE2 may also be negative to produce reversed displays. 
(For further information, see DATAO Displays section (p. 21).) 

Programmer's flow-chart reference; ADDO, 01. 


Change a channel definition 


Key character 

Operands 

C 

xx, {Na} ,SFAE1 ,SFAE2 ,(Dn) ,{Dnn} 


xx: The number of the DATAO channel to be redefined. 

Na: A one- to five-character name for a named location. See appendix B for ac- 
ceptable formats. Default value; The named location currently defined for 
channel xx. 

SFAE1: An SFAE for an EU value to represent the 0-volt output of the display. If 
a name occurs within the SFAE, the current EU value, as located and descaled 
from the named-location definition, is used as the numerical value within the 
SFAE. 

SFAE2; An SFAE for an EU value to represent the 10-volt output of the display. 

If a name occurs within the SFAE, the current EU value, as located and de- 
scaled from the named-location definition, is used as the numerical value 
within the SFAE . 

Dn; An octal or decimal unit number for one of the Dac units. Default value; Unit 
number as currently defined for channel xx. 

Dnn: An octal or decimal Dac number of unit Dn. Default value: Dac number as 
currently defined for channel xx. 

Description: This command is similar to the A command, except that the channel be- 
ing redefined must already have been defined using the A command. 

Programmer's flow-chart reference; CHNG. 
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Delete the last channel definition 


Key character 

Operands 

D 

None 


Description: The last sequentially defined channel definition is deleted. Note; This 
co mm and may be used any number of times in succession, as an automatic stop 
occurs when no channel definitions remain. 

Programmer’s flow-chart reference: DEOP. 


Delete all channel definitions 


Key character 

Operands 

@ 

None 


Description: All channel definitions are deleted. 
Programmer's flow-chart reference; ATO. 


Display all channel definitions 


Key character 

Operands 

? 

{DF1 2 } 


DF12: Output device number. Default value: Line printer (unit 5). 

Description: The definitions for all the currently defined channels are displayed on 
device DF12. The order of the values on each line of output is the channel num- 
ber, the output unit number in octal, the Dac channel number, the name of the 
named location being displayed, the EU value for 0-volt output, and the EU value 
for a 1 0-volt output. 

Programmer's flow-chart reference; ODAT+6. 

Save channel definitions 


Key character 

Operands 

• 

{DF9} 

VERIFY? YnJDFlO} 
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DF9: The unit number of the output device on which the dump is to occur. Note: 
Either a comma or carriage return may follow DF9. Default value; Paper 
tape punch (unit 2) . 

Yn: A single ASCII character, "Y" or "N", to indicate whether the dump just pro- 
duced is to be verified. 

DF10: The unit number of the input device from which the dump is to be read. 

DF10 should only be entered if Yn is the ASCII character "Y". Default value: 
Paper tape reader (unit 2) . 

Description: All the channel definitions are output on device DF9 in a relocatable 

binary-dump format. This dump may be saved and used to restore these operator- 
defined values at a later date by using the * (restore channel definitions) command. 
The VERIFY? query occurs after completion of the dump. If it is desired to check 
the dump for bit errors, the dump should first be mounted onto device DF10, then 
an ASCII "Y" should be entered for the Yn mnemonic, followed by a value for 
DF10. The dump will then be read and checked against the values in core. If and 
only if an error occurs, CK is printed on the operator's input device, and the com- 
mand is terminated before the entire dump is read. If no verification is desired, 
an ASCII "N" should be entered for the Yn mnemonic and no DF10 should be en- 
tered. 

Programmer's flow-chart reference; PCHO. 


Restore channel definitions 


Key character 

Operands 

* 

{DFIO} 


DFIO: Input unit number. Default value; Paper tape reader (unit 2). 

Description: A dump produced by the DATAO ! (save channel definitions) command is 
read from device DFIO. The channel definitions, as read from this dump, replace 
those channels as currently defined. If a read error occurs during the load pro- 
cess, CK is printed on the operator's input device, all definitions and default val- 
ues are cleared to their initial values, and the command is terminated before the 
remainder of the dump is read. 

Programmer's flow-chart reference-. LODO. 



Accept INFORM commands 


Key character 

Operands 

- 

None 


Description: This command is used to change the input command string back to 
INFORM control-edit commands. 

Programmer’s flow-chart reference: CMDS. 



APPENDIX E 


COMMANDS TO CONTROL SUBROUTINE SAMPLE 

Variables sampled by subroutine SAMPLE are assigned channel numbers 0 to 79. 
Also assigned to each channel is a starting location for the core storage block to be 
used to save the samples . The length of the storage block is the same for all channels . 
This length must be set the first time the SAMPLE-control command processor is en- 
tered after a program load. If averaging is being used, that is, if the number of aver- 
ages specified is two or more, the defined block length must be at least two times the 
number of samples taken. The block length may be changed at any time by using the 
B command. The number of points to be averaged to determine a sample must also be 
defined at this time. If this number equals zero or one, averaging is not be used. 

The SAMPLE-control command processor is entered by using the < INFORM 
control-edit command. The computer returns a < sign instead of the underscore when 
the SAMPLE control command processor is in effect. The SAMPLE control commands 
are listed in this appendix. The underscore SAMPLE command will return control to 
the INFORM control-edit command processor. 

Add a new channel definition 


Key character 

Operands 

A 

{Na} ,{Ad} 


Na: A one- to five-character name for a named location. (See appendix B for ac- 
ceptable formats. ) Default value.- The last-used name operand of previous 
commands . 

Ad; An octal or decimal address for the start of the storage block to be used to 
save variable Na’s history. (See appendix B for acceptable formats. ) Default 
value; Address of the highest numbered channel defined plus the current block 
size . An error will occur if Ad is defaulted when no SAMPLE channels have 
been defined. 

Description: The next sequential SAMPLE channel number, as supplied by the ma- 
chine, is defined to store variable Na’s history. The number of the channel being 
defined is displayed immediately after the delimiter separating the "A" key char- 
acter from its operands. The storage space to be used starts at address Ad. The 
next available storage location, which will not be used by this channel, is displayed 
after the command line . This value will only be applicable for the currently de- 
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fined storage block length and averaging mode . For further details see the 
SAMPLE Subroutine Control section. 

Programmer' s flow-chart reference: ADDO,Sl. 


Change a channel definition 


Key character 

Operands 

C 

xx,{Na} ,{Ad} 


xx: The number of the SAMPLE channel to be redefined. 

Na; A one- to five-character name for a named location. See appendix B for ac- 
ceptable formats. Default value; The named location currently defined for 
channel xx. 

Ad: An octal or decimal address for the start of the storage block to be used to 
save Na' s history. Default value; The address currently assigned to chan- 
nel xx. 

Description: This command is similar to the A command preceding except that the 
channel being redefined must already have been defined using the A command. 

Programmer' s flow-chart reference: CHNG. 

Delete the last channel definition 


Key character 

Operands 

D 

None 


Description: The last sequentially defined channel definition is deleted. Note: This 
command may be used any number of times in succession, as an automatic stop 
occurs when no channel definitions remain. 

Programmer's flow-chart reference: DROP. 

Delete all channel definitions 


Key character 

Operands 


None 


Description: All channel definitions are deleted. 
Programmer' s flow-chart reference : ATO . 
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Display channel definitions 


Key character 

Operands 

? 

{ DF1 2 } 


DF12; Output device number. Default value: Line printer (unit 5). 

Description: The definitions for all the currently defined channels are displayed on 
device DF12. The order of the values on each line of output is the channel num- 
ber, the output-unit number in octal, the Dac channel number, the name of the 
named location being displayed, the EU value for 0-volt output, and the EU value 
for a 10-volt output. 

programmer's flow-chart reference: ODAT+6. 


Define block length 


Key character 

Operands 

B 

BLOCK SIZE={No} 

# AVERAGES= {Noo} 


No: An octal or decimal number to define the new storage block length. Note: No 
should be terminated with a carriage return. 

Noo: A positive octal or decimal number indicating the number of readings being 
averaged to determine a sample . It is displayed when the ? command is 
issued. Note: Noo should be terminated with a carriage return. 

Description: The storage block length for all channels is immediately changed to No, 
and Noo becomes the assumed number of averages being taken for each sample 
point (the actual number is controlled by the program calling SAMPLE). When 
the data are output using the $1 or $2 commands, the data stored in the storage 
block are assumed to be the summations of Noo readings at each sample point. 

This assumption is made regardless of how the main program calls SAMPLE or 
any previous condition of No and Noo in effect when the data were taken. If Noo is 
greater than one, the data are treated as double-precision integers, and are divid- 
ed by Noo to obtain a single-precision integer value before output. Therefore, if 
Noo is greater than one, No must be twice the number of sample points; otherwise, 
No should equal the number of samples to be taken. 

Warning : In general, No and Noo should not be changed until after any data 
collected are output using the $1 and $2 commands. Otherwise, the output may be 
incorrect. It is permissible, however, to change No and Noo at any time provided 
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the operator realizes these consequences. (See the SAMPLE calling sequence for 
additional information, p. 12.) 

Warning: The starting location of each storage block is not changed. Hence, 
increasing No from its present value may result in overlapping blocks unless suffi- 
cient space was originally allocated for each block. The program has no provision 
to determine whether storage bounds may be exceeded, and it is up to the operator 
to insure that each block maintains its integrity . If Noo is increased from one to 
greater than one, the number of samples fitting in a storage block is automatically 
cut in half. The main program need not be altered if it uses the abort- return loca- 
tion to determine when all samples are in, since the return to this location will 
automatically occur sooner. 

Programmer's flow-chart reference: SZE. 

Save channel definitions 


Key character 

Operands 

J 

{ DF9} 

VERIFY? Yn, {DF10} 


DF9: The unit number of the output device on which the dump is to occur. Note*, 
either a comma or carriage return may follow DF9. Default value: Paper 
tape punch (unit 2). 

Yn; A single ASCII character, "Y" or "N", to indicate whether the dump just pro- 
duced is to be verified. 

DF10: The unit number of the input device from which the dump is to be read. 

DF10 should only be entered if Yn is the ASCII character "Y". Default value: 
Paper tape reader (unit 2). 

Description: All the channel definitions are output on device DF9 in a relocatable 

binary-dump format. This dump may be saved and used to restore these operator- 
defined values at a later date by using the * (restore channel definitions) command. 
The VERIFY? query occurs after completion of the dump. If it is desired to check 
the dump for bit errors, the dump should first be mounted onto device DF10, then 
an ASCH "Y" should be entered for the Yn mnemonic, followed by a value for DF10. 
The dump will then be read and checked against the values in core. If and only if 
an error occurs, CK is printed on the operator's input device, and the command is 
terminated before the entire dump is read. If no verification is desired, an ASCII 
"N" should be entered for the Yn mnemonic and no DF10 should be entered. 

Programmer's flow-chart reference: PCHO. 
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Restore channel definitions 


Key character 

Operands 

* 

{ DF1 0} 


DF10: Input unit number. Default value; Paper tape reader (unit 2). 

Description: A dump produced by the SAMPLE ! (save channel definitions) command 
is read from device DF10. The channel definitions, as read from this dump, re- 
place all existing channel definitions. If a read error occurs during the load pro- 
cess, CK is printed on the operator's input device, all definitions and default val- 
ues are cleared to their initial values, and the command is terminated before the 
remainder of the dump is read. 

Programmer' s flow-chart reference: LODO. 


Accept INFORM commands 


Key character 

Operands 

- 

None 


Description: This command is used to change the input command string back to 
INFORM control-edit commands. 

Programmer's flow-chart reference: CMDS. 
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APPENDIX F 


DESCRIPTION OF REQUIRED SUPPORTIVE SOFTWARE 
Subroutines required: 

Standard Fortran: L$22, H$22, M$22, D$22, A$22, S$22, N$22, C$12, C$21, 
C$42, C$24 

CIPHER input-output libraiy: MESAGE, PUNCH, LOAD, VERIFY, INPT, AIP, 
AOP, OUTOO, OUT11, OUT22, TTYR, FDDH, FDD11, FDD22, FDDEND 
Since complete descriptions of the functions of all the routines listed here are con- 
tained in appendix H, only an overview of the routines' application is given here. 

In the program descriptions given in this appendix DAC, as assembly language 
pseudo-operation, is used to represent a direct address constant produced by the pro- 
gram loader. The value stored in the reserved location is equal to the address of the 
parameter named in the DAC statement. In addition to the machine's hardware A, B, 
and X registers, pseudoregisters are defined in map or page zero memory as follows: 

Location Description Register 


0 

Common core 

V 

1 

Common core 

W 

2 

First floating-point accumulator 

AA 

3 

Second floating-point accumulator 

AA 

4 

Third floating-point accumulator 

BB 

5 

Fourth floating-point accumulator 

BB 

6 

Return address register 

R$TN 

7 

Output-device number 

OUT$ 

8 

Input-device number 

IN$ 


Many arguments passed between subroutines are held in these registers for transfer. 


Standard Fortran Routines 


L$22 

Calling sequence: 
CALL L$22 
DAC operand 
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H$22 

Calling sequence: 

CALL H$22 
DAC storage 

M$22 

Calling sequence: 

Set AA - multiplicand 
CALL M$22 
DAC multiplier 
AA = product 

D$22 

Calling sequence: 

Set AA = dividend 
CALL D$22 
DAC divisor 
AA = quotient 

A$22 

Calling sequence: 

Set AA = addend 
CALL A$22 
DAC addend 
AA = sum 

S$22 

Calling sequence: 

Set AA = minuend 
DAC subtrahend 
AA = difference 

N$22 

Calling sequence; 

Set AA = value to be negated 
CALL N$22 
AA = -AA 

C$12 

Calling sequence: 

Set A - the integer value to be converted 
CALL C$12 
AA = A 

C$21 

Calling sequence: 
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Set AA = floating-point value to be converted 
CALL C$21 
A = the integer of AA 

C$42 

Calling sequence: 

Set (A, B) = double-precision integer 
CALL C$42 
AA = (A, B) 

C$24 

Calling sequence; 

Set AA = floating-point value to be converted 
CALL C$24 

(A, B) = the double-precision integer of AA 


CIPHER Library Input-Output Routines 


MESAGE 

Calling sequence: 

Set OUT$ = the output-device number 
CALL MESAGE 

(X) Data, ASCH characters, stored 2 per word 

Data, 0 - to signify end of message. Note: These data are not needed if 
the last eight bits of last data statement above are zero 
Description: MESAGE provides the assembly-language programmer a means of 
printing table headings or messages with all the ease and convenience of For- 
tran format statements, but with a vastly reduced core requirement. Device 
flexibility is achieved through the use of the AOP subroutine. In addition, 
since the message to be printed appears as data statements representing the 
eight-bit ASCH code following the CALL statement, a convenient comment in 
the form of the actual message is automatically inserted in the assembly list- 
ing. This message aids in identifying parts of the program. 

Subroutines required: AOP 
PUNCH 

CaHing sequence: 

(W) Set A = start address 

(X) Set B = last address punched 

(Y) Set X = output-device number 
CALL PUNCH 
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(Z) Data, number of spaces in leader 
Subroutines required: Set AOPX, LOAD, VERIFY 
LOAD 

Calling sequence: 

(W) Set A = start address 

(X) Set B = end address 

(Y) Set X = input-device number 
CALL LOAD 

Error- in- reading return point 
No-error, or normal-return point 
Subroutines required: Set AIPX, AOP, VERIFY, MESAGE 
VERIFY 

Calling sequence; 

(W) Set A = start address 

(X) Set B = end address 

(Y) Set X = input-device number 
CALL VERIFY 

Error-in- verification return point 
No-error or normal-return point 
Subroutines required: Set AIPX, LOAD, MESAGE 

Description for PUNCH, LOAD, and VERIFY: These routines are a packaged set 
that generates dumps designed to be read by a person or by Fortran-coded 
programs . 


Calling sequence; 

Set IN$ = input-device number 
CALL AIP 

A = 16 bits from the IN$ device 

AIPR 

Calling sequence; 

Set IN$ = input-device number 
CALL AIPR 

A = A + 8 bits from device X 


Calling sequence; 

OUT$ - output-device number 
Set A = 16 bits for the OUT$ device 
CALL AOP 


100 



AIPX 

Calling sequence: 

Set X = input-device number 
CALL AIPX 

A = 16 bits from device X 

AOPX 

Calling sequence: 

Set X = output-device number 
Set A =-16 bits for device X 
CALL AOPX 

AIPRX 

Calling sequence: 

Set X = input-device number 
CALL AIPRX 

A = A + 8 bits from device X 

INPT 

Calling sequence: 

Set IN$ = input-device number 
CALL INPT 

A = 8 bits from the IN$ device 

Description for AIP, AOP, AIPX, AOPX, AIPRX, and INPT: These surboutines 
are designed to provide a moderate level of device-free I/O capability to the 
assembly-language programmer. By using this software package, the 
assembly-language programmer frees himself of the highly specialized and 
machine-dependent nature of many I/O functions . By having at least two 
channels of device-free I/O, one immediately gains the flexibility of software 
and ease of programming normally only encountered on large computing sys- 
tems, such as the IBM TSS 360/67 systems. The device flexibility that 
INFORM enjoys is directly attributable to use of these routines. 

OUTOO 

Calling sequence: 

(X) Set A = an octal value to be printed 
CALL OUTOO 

Set OUT$ = output-device number 

DAC, number of least- significant digits printed 

Subroutines required: Set AOP 

OUTIO: See OUTOO 

OUT11 

Calling sequence: 
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Set OUT$ = output-device number 
Set A = an integer to be printed 
CALL OUT11 

DAC number of significant digits printed 
Subroutines required: OUT44 
OUT22 

Calling sequence: 

Set OUT$ = output-device number 

(X) Set AA = floating-point real value printed 
CALL OUT22 

(Y) DAC format word. The mantissa length is the least-significant six bits 

of the format word. The exponent length is the next three bits . The 
remainder of the format word is used to indicate the position of the 
decimal point and whether it is printed. 

Subroutines required: OUT44 
OUT12 

Calling sequence: 

Set OUT$ = output-device number 

(X) Set A = integer to be printed 
CALL OUT12 

(Y) DAC format word (See OUT22 format word. ) 

Subroutines required: OUT22, C$12 

OUT 21 

Calling sequence: 

Set OUT$ = output-device number 
(ZZ) Set AA = floating-point real value printed 
CALL OUT 21 

(Y) DAC number of significant digits printed 
Subroutines required: C$21, OUT44 
OUT44 

Calling sequence: 

Set OUT$ = output-device number 
(ZZ) (A, B) = double-precision integer printed 
CALL OUT44 

(Y) DAC number of significant digits printed 
Subroutines required: AOP 

Description of the OUTxx routines: This portion of the CIPHER I/O package is 
intended to give the assembly-language programmer a moderate amount of 
format flexibility when numbers need to be displayed in a man-machine inter- 
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face situation. By developing this set of highly efficient, general purpose rou- 
tines, the generally annoying and time consuming task of writing code to print 
numbers in assembly language is eliminated. Although they do not offer the 
complete flexibility available in Format format statements (10-digit mantissa 
ma ximum , no leading zero suppression) they do offer the same ease of pro- 
gramming, without requiring the vast amount of core associated with format- 
decoding routines . The inclusion of a double-precision integer format and the 
exclusion of a double-precision, floating-point format should more closely 
tailor these routines to assembly-language requirements than Fortran format 
decoders . 

The output is sufficiently flexible that it should meet a wide range of aes- 
thetic as well as practical needs. The exclusion of the decimal point and ex- 
ponent sign from the floating-point format may offend the sensibilities a bit, 
but this was done to meet the requirements of the FDDxx series of subroutines 
and thereby simplify them considerably. In addition, a small increase in out- 
put speed for slow I/O devices is achieved. If these considerations are not 
requirements, the decimal point and exponent sign can easily be inserted. 

TTYR 

Calling sequence; 

Set IN$ = input-device number 
CALL TTYR 

(Y) DAC floating-point storage 
(ZZ) AA = number input 

(W) X = delimiter character causing return 

(Z) B = type of entry information: B > 0 indicates decimal entry; B < 0 indi- 

cates octal entry; B = 0 indicates no entry (AA = 0) 

Subroutines required: AIP, MESAGE 
TTYR2 

Calling sequence: 

Set IN$ = input-device number 

(X) Set A = the first input character 
CALL TTYR2 

(Y) DAC floating-point storage 
(ZZ) AA = number input 

(W) X = delimiter character causing return 

(Z) B = type of entry information: B > 0 indicates decimal entry; B < 0 indi- 

cates octal entry; B = 0 indicates no entry (AA = 0) 
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Subroutines required: TTYR 

Description: TTYR is a versatile routine that finds application whenever the man- 
machine interface deals with single-precision integers or floating-point nu- 
merical values entered by man. Its free-format style of number entry has al- 
ready been amply described by the description of octal-or-decimal numbers in 
appendix B . The program can return information to the calling program de- 
scribing the type-of-number entry, the delimiter that caused branch back, and 
the value intended. This ability, when coupled with the TTYR2 entry point, 
which accepts a previously input character, yields virtually limitless use of 
the program . Input device independency is achieved through use of the ATP 
subroutine . 

FDDH 

Calling sequence: 

Set OUT$ = output-device number 

(W) Set A = identification number 

(X) Set B = number of digits for A output 
CALL FDDH 

(Y) Data, number of data words per line 

(Z) Data, coded integer. Least significant six bits, the number of digits in 

mantissa of the length of integers excluding sign; next three bits, the 
length of exponent less sign; remaining bits, number of digits in 
checksum excluding sign. 

Subroutines required: OUT11, all the FDDxx type subroutines 
FDDEND 

Calling sequence: 

Set OUT$ = output-device number 
CALL FDDEND 

Subroutines required: MESAGE, all the FDDxx type subroutines 
FDDH 

Calling sequence: 

Set OUT$ = output-device number 
(X) Set A = integer to be output 
CALL FDDll 

Subroutines required: OUT11, MESAGE 
FDD 21 

Calling sequence: 

Set OUT$ = output-device number 
(ZZ) Set AA = floating-point value to be output 
Subroutines required: OUT21, MESAGE 
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FDD22 

Calling sequence: 

Set OUT$ = output-device number 
(ZZ) Set AA = floating-point value to be output 
CALL FDD22 

Subroutines required: OUT22, MESAGE 
FDD12 

Calling sequence: 

Set OUT$ = output-device number 
(X) Set A = integer to be output 
CALL FDD12 

Subroutines required: FDD22, C$12 

Description of the FDDxx subroutines: These subroutines are intended as a 

general-purpose software package to produce dumps of data that will undergo 
further processing by being read into another computer. All characters are 
produced using the ASCII code, and the format of the numbers is that of the 
OUTxx routines, which is easily interpreted using standard-Fortran integer- 
read statements. Each line of output is terminated with carriage return, line 
feed, and XOFF characters. The XOFF character is provided for automatic 
control of hardware that can read dumps into a time-share system. Persons 
who wish to use this postprocessing capability should tailor the line terminator 
characters to their systems . 
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APPENDIX G 


FLOW CHARTS 
Flow Chart Symbols 

Symbols used in the flow charts are taken from ANSI Standard X3. 5-1970 (ref. 2) 
except as noted below . 

Names of subroutines are located above and to the left of the block: 



Refers to subroutine ABCD 


Arguments that are passed to and from subroutines are indicated in parenthesis by the 
enter and exit symbols; that is, 



Indicates that X is received from the calling program and Y, Z are returned. Note; 
This notation does not refer to arguments held in common core. 

The following conventions are used to indicate various addressing modes. 

Refers to the integer, floating point, etc., contents of memory location(s) 
ABCD. 

Indicates that memory location ABCD contains the address of the memory 
cell or cells which contain the value desired. 

Refers to the I^ 1 value in array ABCD. 


ABCD 

{ABCD] 

ABCD(I) 
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(A, B) Is used when- it is required to show how two integer words are concatenated 

to form a double-precision integer, floating-point real, or other two- 
word value . 

Encloses a group of processing functions designed to accomplish a specific 
task. 

When a connector symbol contains an asterisk, the flow proceeds to the 
point whose address is in RTRN; that is, RTRN contains a word which 
points to the proper flow point. 



Flow Chart Notes 

(1) The actual method used to perform the packing is immaterial, since the NAME 
subprogram is the only place where packing is done. The PNAM routine, which is 
used to print a name, is the only other routine in addition to NAME which needs to be 
modified if packing different from that described below is used. If we label a 16-bit 
word such that the most significant bit is 1 and the least significant bit is 16, then the 
method used in the SEL 810B is as follows: 

Bits(3 - 8) of BUF(O) go into bits(ll - 16) of BUF(O) 

Bits (9 - 14) of BUF(O) go into bits(ll - 16) of BUF(l) 

Bits(15 and 16) of BUF(O) go into bits(ll - 12) of BUF(2) 

Bits(l and 4) of BUF(l) go into bits(13-16) of BUF(2) 

Bits(5 - 10) of BUF(l) go into bits(ll - 16) of BUF(3) 

Bits(ll - 16) of BUF(l) go into bits(ll - 16) of BUF(4) 

(2) A particularly efficient means of implementing this block is to do an indexed 
branch using the truncated ASCII delimiter code passed back from the NAME subrou- 
tine as the index. For further details consult the PROGRAMMING NOTES section. 

(3) Recall that each element of the TAB1, TAB2, and TAB3 data tables for which 
this routine is used is only 8 bits long; hence, 2 elements are stored in one 16-bit 
word. Even indices are stored in the most significant bits, odd the least. 

(4) The LIO, LI1, LI2, LI4, LI6, LI7, LI8 program branch points use the same 
loop (LI15) to format the table output, add an increment to the core address pointer B, 
and determine when all values have been printed. The CD11 is used to modify the re- 
turn point of LI15 so that different interpretations to the core values and different 
printouts can be implemented efficiently. Use of CD11 is thus similar to use of RTRN. 

(5) The UOC, NAM1, NAM 2, SF , TAB1, TAB2, TAB3, LGTH, and DFO tables, 
along with ACUM and CFMT, occur sequentially in core. Therefore, the values of all 
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these parameters will be saved on the relocatable binary dump produced by the PU 
subprogram. 

(6) XOl, DAI, NCH, and CHIX contain the addresses of SI, TORG, NSCH, and 
SIDX (with postindexing affixed) or the addresses of Ol, DK1, NDCH, and DIDX (with 
postindexing affixed) . The values depend on whether the command processing routines 
(ATO, ADDO, CHNG, DROP, DODO, PCHO) are initialized to process SAMPLE or 
DATAO control commands. All references to XOl, DAI, NCH, and CHIX are done 
indirectly, thus effectively changing the operand for the above mentioned routines. 

Also see the DATAO and SAMPLE command processor section under program struc- 
ture. 

(7) The DK1, DEXP, DK2, DK2B, DIDX, DCHN, and DDAC tables, along with 
location NDCH, occur sequentially in core. The TORG and SIDX tables, along with 
locations NAVG, AVLH, SVLH, SIZE, and NSCH, also occur sequentially in core. 
Therefore, the values of the table set referenced (see note 6) will be saved on the re- 
locatable binary-dump tape produced by the PU subprogram . It is extremely important 
that the tables and locations mentioned occur in the specified order so that an error 
occurring when reloading dumps will not adversely affect machine operation; that is, 

to prevent SAMPLE from erroneously storing on top of program instructions or DATAO 
from producing extraneous output to random devices. 

(8) The DATAO subroutine achieves rapid output capability by executing machine- 
coded instructions generated in the Ol subroutine. These instructions are intended to 
reduce the required Y = Ax + B type calculation to one of integer arithmetic that can 
be executed at high speed. This high-speed capability is necessary since DATAO is 
designed to display the dynamic behavior of the named locations selected. 

(9) This test, which may involve several instructions, is actually performed in the 
GSF subroutine, which passes an argument back to indicate the result of the test. 

(10) Note that if the default value X, supplied from the calling program, is not 1, 

2, or 3, this routine will branch to EROR. This is important, as calling programs 
depend on GTAB to validate their default values. Also, this routine may be forced to 
not permit defaults by supplying an erroneous default value. 
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Except for ODAT and SPL, the command processors for the INFORM commands follow 
in alphabetical order. 



SUFX 



Obtain indexing variable 
for name operand. Use 
zero for default. Save 
in INDX 


TADD 

t 

. 

Add INDX to open 
data table 




PRFX 


Verify proper prefix 
command format. 

Put command delimiter 
in DLM2 
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No such 
command 


Input ASCII 
character from 
operator's keyboard 


Obtain BB value of 
SFAE from operator. 
Use address for 


/ Is \ 
character 
0, 1, 2, or 3 


Convert BB 
to integer 
B = BB 


Operand may not 
be defaulted 


Verify proper prefix 
command format; put 
command delimiter 
in DLM2 


Print B in octal 
on OUT$ device 


Branch 
on ASCII 
character 


Obtain scale factor 
AA from operator 


Print AA in floating 
point on OUT$ device 


Obtain AA, an SFAE 
from operator. Use 
EU values for names 


Print first words 
of A A in octal 
.on OUT$ device , 


Obtain AA, an SFAE 
value from operator; 
use EU value for names 


'Print second word' 
of AA in octal on 
\OUT$ device ; 


L3 














Clear incrementers 
INC1 = 0 
INC2 - 0 


Save name 
operand 
TNA = BUF 


Clear indexing 
variable 
ASNX = 0 
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DFMT 


DISP 


Verify proper prefix 
command format 
Put command 
delimiter in DLM2 


Verify proper prefix 
command format 
Put command 
delimiter in DLM2 


Obtain positive integer 
I from operator. No 
default permitted. Put 
delimiter in DLM2 


1 I < DFMT 

fa modifiam&v. 
{Jefault numbejx'* - 


/Set the default \ 
indexing variable 
\ B = 0 / 


No such 
default 


' PrintDFX(I)on\ 
s.OUT$ device 
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PNUM 


1 
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EROR 


Is 

NAVG - 1 
? 


SVLH > 0 
Yes 


Set IN* and 
OUT* devices 
to operator's 
console 



MESAGE, 


Type "Q", ”CRLF" 
on OUT* device 


Obtain indexing variable 
(or name operand. Use 
OLDX for default. Save 
in INDX 


Obtain current value 
from core 

A = iLOCIINDXIl 


'print EU value of 
A using scaling of 
jth name. Use 
\ OUT* device 


' Add increment to 
minor loop counter 
v K - K + 1 


Test A 
for dump 
type 



FDD11 

Convert B to 


Dump B on 

floating point EU 


OUT* device 

BB = BxSVSF 



F0D22 v/ 


Dump BB on 


OUT* device 

U 
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111 aim 


mill i i 


i mi i ii i ai 
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The ODAT and SPL command interpreters and their command processing routines 
follow in alphabetical order. See the DATAO and SAMPLE command processor section 
under PROGRAM STRUCTURE to understand the flow through the command processors. 
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a 










PRFX 


Verify proper prefix 
command format 
Put command delimiter 
in DLM2 


Display DATAO 
Ichannel difinitions 


<1/ Note 7 
Set operands \ 

' to control DATAO\ 
XOl = 01 
DAI s DK1 
NCH = NDCH 
CHIX s DIDX 


'Change the number's, 
of channels limit ) 
NBUF = 24 / 



Set EROR and all 
|command processing 
routines to JUMP 
'here when complete 



Set the input 
and output device 
number 



Input and execute 
DATAO control 
commands 


MESAGE 


( Display 2 digits 
of I on OUT$ 
device 

MESAGEy 


'Print "apostrophy,' 
space" on OUT$ 
Vdevice 


Note I 


Determine A. the 
output number of 
DUNTill instruction 


OUT DO 

( Display 2 octal 
digits of A on 
OUT* device 


Determine B, 
the DAC 

channel number 
B ■ DCHNII) 


OU Tllw 


( Display 2 digits 
of B on OUT$ 
device 



Print name 
whose indexing^ 
variable is 
DIDX(I) on 
^OUT? device 


GSF2 


Get SVSF as scale 
factor for indexing | 
variable DIDXdl 


C$42 


Convert DK2(I) and 
DK2B(I) to floating 
point as AA 


Calculate the EU 
value at 0 volts 
output 

AA - AA " SVSF 


DKl(I)-2' 10 


MESAGEsl 


Print 2 spaces 
on OUTt device 


OUT22slr 


C Display AA 
in floating 
point on 
OUT$ device 



Determine A, the 
scaling power of 2, 
by decoding shift 
instruction in 
DESP(I) 


Calculate EU value at 
10-volt output 

SVSF°VOLT«10. 0 
DK1(I)-2 (A " 10) 


BB=AA : 


OUT22d 


Display BB 
in floating 
point on 
OUT$ device 


_J2_ 


Add increment 
to loop counter 
1 = 1+1 
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DLM2 comma 
^ / 


Nondefauitable 
operands must 
follow 


Select A such 
that 0.5 < 

|CC|-2' ,A+13> <1.0 


Decode B, a Dac 
unit from a past 
DUNT(I) instruction 


Get scale factor SVSF 
for INDX indexing 
variable 


Split CC into an integer 
multiply and a shift. 

Save the multiply 
TDK1 = CC-2' (A+13) -215 


Shift is too big 
for a single 
instruction 


Get positive unit 
number B from 
operator. Use B 
for defaults. DLM2 * 
delimiter 


W2 I* A> 16 


Obtain AA, an SFAE 
from operator. Use 
EU values for names. 
DLM2 = delimiter 


^ Was ^ 

AA defaulted 

? . 


^ Is ^ 
DLM2 comma 
? 


Operand not 
defaultab le 


Nondefaultable 
operand must 
follow 


Print "SPOF" 
on OUT$ 
device 


Set TEX * a full arithmetic 
left shift A times instruction 
if A > 0. or a full arithmetic 
right shift A times 
instruction if A < 0 


Calculate offset 


The offset is 
too great 


CI3/4M2 30 ) 


Set TUN to a write- 
I Dac-unit-B-from- 
! accumulator instruction 


Get Dac B 
from operator. 
Use DCHN(IDXO) 
for defaults. 

DLM2 - delimiter 


Terminate 
command line 


Was 

BB defaulted 


Operand not 
defaultable 


Convert BB to 
double-precision 
integer and save 
in ITDK2. TDKB) 


Is B ^ 
a valid Dac 
number 
\ ^ 


DAC count/volt 


Determine scaling 
multiplier 
_ SVSF • 10 • VOLT 


Save Dac number 
DCHN(IDXO) = B 


Build DAT AO tables: 
DEXP(IDXO) = TEX 
DKl(IDXO) = TDK1 
DK2(IDXO) = TDK2 
DK2BUDXO) = TDKB 
OUNT(IDXO) - TUN 
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PRFX 


(Verify proper 
prefix command' 
(format 


MESAGE , 


/print "CRLF" and\ 
( "SAMPLE SIZE-" 
\ on OUT$ device 


/Clear default 
delimiter 

\DLM2 - "comma'/ 


Get A, a positive 
integer, from 
operator. Use SIZE 
for defaults. DLM2 - 
delimiter 


CKCR 


Validate delimiter; 
terminate line 


MES AGE | 


Clear default 
. DLM2 = "comma" 


Print "CRLF" and\ 
"# AVERAGES 
, on OUT$ device 


Get B, a positive integer, 
from operator. Use SVLH 
for defaults. DUV12 * 
delimiter 
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Flow charts for CLRSMP, DAT AO, and SAMPLE follow. 









Descale and truncate 
output by executing 
SFTO instruction 
A = A 2 shifted 


Machines that output to 
ADC's using two words 
or two instructions 
should generate 2nd 
instruction with DACW 
above and execute it here 












The subroutines used by the command processors follow in alphabetical order 
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Get a name or 
number from 
operator. DLM2 ■ 
delimiter; default 
value *0.0 



lo 

AA • -AA 



' 

( 

S 


Perform operation 
XX-XX-AA 


Perform operation 
XX * XX + AA 



Perform operationj 
XX * XX - AA 


* 


P$22 


Perform operation 
XX • XX/AA 


— i 
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X" \ 


RETURN 
(XX. Y) 
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APPENDIX H 


SUBROUTINE FUNCTIONS 

In the descriptions that follow "external subroutine" refers to subroutines that are 
not part of the INFORM program, "internal subroutine" refers to subprograms that 
are included in the assembly of INFORM. 

ADRS: Internal routine to input operator-supplied octal or decimal addresses. The 
address supplied and information indicating default are passed back to the main 
program as the first and second arguments. The MATH subroutine is used for in- 
put; hence, the delimiter is contained in DLM2. ADRS branches to EROR is the 
address entered is invalid. 

AIP: CIPHER I/O library subroutine that inputs a single word from the I/O device 
whose number is in the IN$ register. The word "input" is passed back in the 
hardware A accumulator. Any commands or software buffers required by the de- 
vice to accomplish a single-byte input task are performed. Information is re- 
turned in the least significant bits of A. The hardware B and X registers are 
unaffected. Only input from devices 1 to 5 is accepted, the input being cancelled 
for other devices. No error messages are issued. 

AIPX: External subroutine that inputs a single word from the I/O device whose number 
is in the hardware X register. The word input is passed back in the hardware A 
accumulator. Any commands or software buffers required by the device to accom- 
plish a single -byte input task are performed. Information is returned starting with 
the least significant bits of A. The hardware B and X registers are unaffected. 
Only input from devices 1 to 5 is accepted, the input being cancelled for other de- 
vices. No error messages are issued. 

AOP: External subroutine that outputs the hardware A accumulator to the I/O device 
whose number is in the OUT$ register. Any commands or software buffers re- 
quired by the device to accomplish a single-byte output task are performed. Only 
input from devices 1 to 5 is accepted, the output being cancelled for other devices. 
No error messages are issued. Output is taken from the most significant bits 
of A. The hardware registers are unaffected. 

AOPX: External subroutine that outputs the hardware A accumulator to the I/O device 
whose number is in the hardware X register. Any commands or software buffers 
required by the device to accomplish a single-byte output task are performed. 

Only output from devices 1 to 5 is accepted, the output being cancelled for other 
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devices. No error messages are issued. Output is taken from the most signifi- 
cant bits of A. The hardware registers are unaffected. 

A$22; External subroutine to add a floating-point real number in the floating-point ac- 
cumulator to a real- valued argument from memory. The real- valued result is in 
the floating-point accumulator. 

CD20: Internal subroutine that receives a floating-point number through the floating- 
point accumulators and scales this number to a machine integer. The result is 
passed back as a floating-point real number. The indexing variable in INDX is 
used to locate the scale factor. 

CKCR: Internal subroutine used to supply carriage returns for command lines termi- 
nated by commas . This routine is used to supply the carriage-return line feeds 
necessary to format lines on the operator's input consol. 

CLRSMP: Subroutine used to clear the storage blocks of the SAMPLE subroutine. 

Used for initialization when SAMPLE is filtering collected data by using the aver- 
aging feature. Its use is optional when SAMPLE is not averaging. 

CMD: Internal subroutine that interprets DAT AO and SAMPLE control command key 
characters and branches to the appropriate command processing routine. Two 
returns to the calling program are implemented; one for ? key characters, and 
one for B key characters. 

C$12; External subroutine that converts the integer value in the hardware A accumu- 
lator to a floating-point real value in the floating-point accumulator. 

C$21: External subroutine that converts the floating-point real value in the floating- 
point accumulator to an integer value in the hardware A accumulator. 

C$24: External subroutine that converts a double-precision value in the hardware A 

and B accumulators to a floating-point real value in the floating-point accumulator. 

C$42: External subroutine that converts a floating-point real value in the floating-point 
accumulator to a double-precision integer value in the hardware A and B accumu- 
lators . 

DATAO: Dynamic data display program described in this report. 

D$22: External subroutine to divide the floating-point real value in the floating-point 
accumulator by the real- valued argument from memory. The result returns in the 
floating-point accumulator. 

FDDEND: CIPHER I/O library subroutine used to terminate a data dump initiated by 
the FDDH subroutine. It will terminate any incomplete line and produce an addi- 
tional line representing a checksum for the incomplete line. If FDDEND is called 
more than once in succession, only the first call will produce output. If the last 
line of the data dump was complete, no output will ever occur. This subroutine 
will also re-initiate for subsequent data dumps by executing a portion of FDDH, 
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but it will not print a header line nor change the output format as does the FDDH 
subroutine. See the "$1" and M $2" command descriptions for typical outputs using 
these routines. The I/O device whose number is in the OUT$ register is used. 

FDDH: CIPHER I/O library subroutine to set the format for and to initialize data 
dumps; The first argument supplied through the hardware A accumulator is 
printed as an integer on the first line twice. The number of significant digits ap- 
pearing is set by the integer value of the second argument. The third argument is 
an integer indicating the number of data points to be printed on each line preceding 
the checksum for that line. The fourth argument is a coded binary number setting 
the format of the data output routines FDD11, FDD22, etc. The least significant 
six bits indicate the number of digits to be output for integer values printed by the 
FDDH subroutine or the number of digits of the mantissa for real values printed 
by the FDD22 subroutine. The next most significant three bits indicate the number 
of digits to be output for the exponent of real values. The remaining bits indicate 
the number of digits appearing in the integer checksum for each line. See the "$1" 
and "$2" command descriptions for typical outputs using these routines. The I/O 
device whose number is in the OUT$ register is used. 

FDDH: CIPHER I/O library subroutine to output integer values from the hardware A 
accumulator in an integer format on the dump initiated by the FDDH subroutine. 

The checksums and line terminators are automatically printed when required as 
dictated by the last call to FDDH. The I/O device whose number is in the OUT$ 
register is used. See the $1 and $2 command descriptions for typical outputs using 
these routines. 

FDD12; CIPHER I/O library subroutine with the input of FDDH and the output of 
FDD22. 

FDD21: CIPHER I/O library subroutine with the input of FDD22 and the output of 
FDDH. 

FDD22; CIPHER I/O library subroutine to output floating-point real values from the 
floating-point accumulator in a floating-point format on the dump initiated by the 
FDDH subroutine. The checksums required are automatically printed when re- 
quired as dictated by the last CALL to FDDH. The I/O device whose number is in 
the OUT$ register is used. See the $1 and $2 command descriptions for typical 
outputs using these routines. 

FDDH: CIPHER I/O library subroutine similar to FDDll except the arguments are 
double-precision integer. 

FIND: Internal subroutine used to locate names in the NAM1 and NAM2 tables. The 
NAM1 and NAM2 tables are searched for the name residing in BUF. A method is 
also used to indicate to the calling program whether the name was located as a de- 
fined name. If found, a normal return occurs, with the indexing variable in the 
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hardware B accumulator . If not found, a different return point is used with the 
value of ACUM in the hardware B accumulator. 

GSF : Internal subroutine to obtain the floating-point real- valued scale factor from the 
SF table . The indexing variable supplied as the first argument in the hardware B 
accumulator is used. The scale factor is returned in SVSF. The second argu- 
ment, returned through the A accumulator, indicates whether the scale factor was 
zero. 

GSF2: Internal subroutine that used GSF to obtain, in SVSF, the floating-point, real- 
valued scale factor from the SF table . The indexing variable supplied as the argu- 
ment is used. If the scale factor is zero, it is set to one. 

H$22: External subroutine used to store the floating-point real value of the floating- 
point accumulator in the argument memory location. 

GTAB: Internal subroutine used to obtain the data table number or format type num- 
bers from the operator. The routine used PNUM to obtain the number and uses 
the value supplied as the first argument as a default value. The resulting numer- 
ical value is checked before it is passed to the calling program as the second argu- 
ment. If the value is not 1, 2, or 3, the routine branches to EROR. 

INFORM: The subject of this report. 

INPT: CIPHER I/O library subroutine that inputs and outputs a single eight-bit charac- 
ter using the I/O devices whose numbers are in the IN$ and OUT$ registers. The 
character is returned in the least significant eight bits of the hardware A accumu- 
lator. If the character was a carriage return, a carriage-return and line feed is 
turned around to the OUT$ device. The AIP and AOP subroutines are used for I/O. 

IVAR: Internal subroutine used to unpack indexing variables from data-table sequences 
contained in TAB1, TAB2, or TAB3. This subprogram requires that the DAC lo- 
cation be established as a postindexing pointer to either TAB1, TAB2, or TAB3. 
The sequence number of the data table is supplied through the hardware A accu- 
mulator. 

LOAD: CIPHER I/O library subroutine used to load relocatable-binary-dump tapes 
produced by the PUNCH subroutine. The first argument is the I/O device to be 
used and is passed in the hardware X register. The values read are stored in 
memory starting at the memory address supplied as the second argument in the 
hardware A accumulator up to and including the memory address supplied as the 
third argument in the hardware B accumulator. If a checksum error is detected, 
a diff erent return point is used, and no further operation takes place. Preceding 
this return, CK is printed on the device whose number is in the OUT$ register. 

The arguments supplied through the hardware registers remain intact on program 
exit. All device operations required for proper input and output are performed. 
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The AIPX and AOPX subroutines are used for I/O. Note; This subroutine does 
not open or close device files; thus multiple dumps may be read in succession. 

L$22; External subroutine used to load the real- valued argument in memory into the 
floating-point accumulator. 

MATH: Internal subroutine used to input and evaluate a sequentially formed arithmetic 
expression from the operator. The first argument, returned through the floating- 
point accumulator, is the value of the expression. The second argument, returned 
in the hardware A accumulator, is an indicator for default detection. If the SFAE 
is defaulted, the first argument is set to zero. Any character not part of the SFAE 
is used as a delimiter to cause return. Its value is held in DLM2. Improperly 
formatted SFAE’s cause a branch to EROR. 

MESAGE: External subroutine to print messages on the I/O device whose number is in 
the IN$ register. The message to be printed is supplied as an argument. The 
AOP subroutine is used for output. The hardware registers are unaffected. 

M$22: External subroutine used to multiply the floating-point real value in the floating- 
point accumulator by the real- valued argument in memory. The result is in the 
floating-point accumulator . 

NAME; Internal subroutine that gathers a name for a named location from the opera- 
tor. The I/O device whose number is in the IN$ register is used. The name ob- 
tained is packed and stored in BUF . (See text for packing details . ) A return oc- 
curs if the first character of the name is not alphabetic or when the first nonalpha- 
numeric entry is received. A latch (NLTH) is set if no name character was en- 
tered before the branch back character. In this case the name stored in BUF con- 
sists of five spaces (the no-name name) . 

NANU: Internal subroutine used to gather either numerical or name entries from the 
operator. The routine distinguishes names from numbers and detects defaults. 

The first argument returned will be an indexing variable in the hardware B accu- 
mulator, if a name was entered, or a floating-point real value in the floating-point 
accumulator, if a number was entered. The second argument returned is an indi- 
cator of what type was detected. The routine uses the NAME and TTYR2 subrou- 
tines. 

N$22: External subroutine used to negate the floating-point real value in the floating- 
point accumulator. 

OPNT : Internal subroutine that prints six octal digits of the integer argument supplied 
in the hardware A accumulator. This value, which is printed using the OUTOO 
subroutine, is preceded by one space and one apostrophy . The value is followed 
by two spaces. The I/O device whose number is in the OUT$ register is used. 

OUTOO: CIPHER I/O library subroutine that prints octal digits of the integer argument 
supplied in the hardware A accumulator . The number of digits printed is supplied 
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as an integer argument and must be a value between 1 and 6 . If the number being . 
printed has a significant digit beyond the number of digits requested, an asterisk 
is printed for all digits. The hardware A, B, and X registers are unaffected. 

All I/O is done using the AOP subroutine . 

OUTil: CIPHER I/O library subroutine that prints decimal digits of the integer argu- 
ment supplied in the hardware A accumulator on the I/O device whose number is 
in the OUT$ register. The number of digits printed is supplied as an integer argu- 
ment. If the number being printed has a significant digit beyond the number of 
digits requested, and asterisk is printed for all digits . The hardware registers 
are unaffected. All I/O is done using the AOP subroutine. 

OUT22,OUT12: CIPHER I/O library subroutine that prints the floating-point real value 
(integer value for OUT12) in the floating-point accumulator (hardware A accumu- 
lator for OUT12) on the I/O device whose number is in the IN$ register. The for- 
mat is determined by a coded integer argument. If the number being printed has 
a significant digit beyond the number of digits requested, an asterisk is printed for 
all digits. The floating-point accumulator and hardware registers are unaffected. 
All I/O is done using the AOP subroutine. Double-precision integer values of the 
mantissa and exponent printed are returned as arguments in common core . 

Ol: Internal subroutine that represents the unique portion of the ADDO sequence which 
adds a channel definition to DATAO . All required operands except the name oper- 
and are input from the operator. Entires are made into the DK1, DK2, DK2B, 
DCHN, DUNT, and DEXP matrices. The position used is equal to the integer in- 
dex of IDXO. Inputs are accomplished using various I/O subroutines and occur on 
the device whose number is in the IN$ register. 

PFX2; Internal subroutine used for checking the operator's command line format when 
the command has no operands. If the operator enters an operand, the routine 
branches to EROR. 

PNAM: Internal subroutine to print a name of a named location from the NAM1 and 
NAM2 tables. The indexing variable to be used is supplied through the hardware 
B accumulator. 

PNUM: Internal subroutine to input octal or decimal numbers from the operator, con- 
vert them to integer values, and verify that they are positive. The number to be 
used if the operator defaults is supplied by the calling program as the first argu- 
ment. The effective input is returned as the second argument. Before this argu- 
ment is returned, it is tested to see if it is a positive integer. If it is not, the 
command in progress is cancelled by a branch to EROR. Hence, operator defaults 
are excluded if the default supplied as the first subroutine argument is negative . 
The TYR subroutine is used to input the numbers, and the delimiter that caused 
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the return is saved in DLM2. PNUM will exit to EROR if this delimiter is neither 
a carriage return or comma. 

PRFX: Internal subroutine to verify that no name was entered before the co mma nd 
keyword. It is used by commands not using a name operand. A branch to EROR 
occurs if a name was entered. 

PU: Internal subroutine to produce relocatable binary-dump tapes of the core locations 
between and including the addresses of the arguments supplied. This routine com- 
pletes the command line by receiving the I/O device operator from the operator. 
Provision is also made for the operator to verify the dump produced if desired. 

The PUNCH and VERIFY subroutines are used to produce and verify the dump. 

PUNCH: CIPHER I/O library subroutine to produce relocatable binary-dump tapes of 
the core locations between and including the addresses of the first aid and second 
arguments supplied through the hardware A and B accumulators . The I/O device 
number supplied as the third argument in the hardware X register is used. The 
AOPX subroutine is used for output. Note: This subroutine does not open or close 
device files, so that multiple dumps may be produced in succession. The argu- 
ments supplied through hardware registers remain intact on program exit. 

SAMPLE: Dynamic data collection program described in this report. 

SETU: Internal subroutine that establishes DAC as a postindexing pointer to the data 
table number supplied in the hardware B accumulator. Also sets STOP equal to 
the length of the data table and returns this value in the hardware A accumulator. 

SPCR: Internal subroutines used to obtain an indexing variable for a data table. The 
indexing variable is tested to see if it equals the blank space or line terminating 
codes. If it does, the proper number of spaces to produce a blank in the table or 
a carriage-return line feed is printed. Two return locations from the subroutines 
are used: one to indicate that a blank or "CRLF" was printed, and one to indicate 
nothing was printed. 

STTS: Internal subroutine used to print the definition of a named location on the output 
device whose number is in OUT$. 

SUFX; Internal subroutine used to obtain the indexing variable of named-location oper- 
ands for commands that use and permit a default of the name operand. The index- 
ing variable to be used for defaults must be supplied as the first argument. The 
effective indexing variable as entered or defaulted is returned as the second argu- 
ment. If an undefined name is entered, the routine branches to EROR. 

SI: Internal subroutine that represents the unique portion of the ADDO sequence that 
adds a channel definition to SAMPLE . All required operands except the name op- 
erand are input from the operator. Entries are made into the TORG matrix at the 
position indicated by the IDXO index. 
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S$22: External subroutine that subtracts the real-valued operand from the floating- 
point real value in the floating-point accumulator. The result resides in the 
floating-point accumulator. 

TADD: Internal subroutine that adds the indexing variable supplied through the hard- 
ware B accumulator to the open data-table sequence array, TAB1, TAB2, or 
TAB3. The command in progress is cancelled by a branch to EROR if the length 
permitted for the open table is exceeded. If no data table is open, no action is 
taken; but the instruction in effect is cancelled by a jump to the address contained 
in RTRN. 

TTYR: CIPHER I/O library subroutine used to input octal or decimal numbers from 
the input device whose number is in the IN$ register. A return from the subrou- 
tine occurs whenever a nonnumeric character, except +, -, E, ', S, B, or rubout, 
is entered. On return, the fourth argument contains the character that caused the 
return, and the third argument contains a value to describe which type of input 
format was used. A value greater than zero indicates a floating-point format, a 
value less than zero indicates an octal format, and a value of zero implies the 
number was defaulted. The numerical value or second argument is zero for de- 
faulted numbers . The number entered is returned in floating-point real format in 
the floating-point accumulator as is also stored in a location supplied as the first 
argument. The AIP subroutine is used for all inputs. 

TTYR2: Additional entry point to TTYR used when the first character to be supplied 
from the input device has already been input and is received as an argument in- 
stead . 

TYR: Internal subroutine that calls the TTYR subroutine and puts the delimiter passed 
as the fourth argument from TTYR in DLM2. The format type supplied by TTYR 
as the third argument is retained and passed as the second argument. The number 
input by TTYR is passed as the first argument in the floating-point accumulator 
and locations N . 

UNIT: Internal subroutine through which all unit number command operands are 

gathered. The first argument passed to the subroutine is the value to be used for 
defaults . The effective unit number determined by operator entry or default is 
passed back as the second argument. The delimiter is saved in DLM2. This rou- 
tine also calls CKCRto terminate a command input line. 

VAL: Internal subroutine used to descale and print the value of the integer operand 

supplied as the first argument. The indexing variable supplied as the second argu- 
ment is used to locate the scale factor to be used. The MESAGE and OUT 22 sub- 
routines are used to print the calculated value in standard floating-point format 
preceded by one space . 
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VERITY: CIPHER I/O library subroutine that reads a relocatable binary-dump tape 
produced by the PUNCH subroutine. The tape is read from the I/O device number 
supplied as the first argument in the hardware X register and compared with the 
values in memory. The starting and ending addresses are supplied as the second 
and third arguments. If no error is detected, return is to return point 2. If an 
error is detected in either the memory comparison or checksum validation, a re- 
turn to point 1 occurs and no further verification takes place. Preceding this re- 
turn, "CK" is printed on the I/O device whose number is in the OUT$ register. 

The hardware A, B, and X registers are unaffected. All input and output are done 
through the AOP and AIPX subroutines. Note: This subroutine does not open or 
close the device files so that multiple dumps may be read in succession. 

XOl: Equivalent to SI or Ol. (See appendix G, flow chart note 6. ) 
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APPENDIX I 


SUMMARY OF COMMANDS 


INFORM COMMANDS 2 


Page 

Description 

Prefix 

operand 

Key 

character 

Additional operands 

Default values and notes 




Mode control 


69 

Enable variable trip mode 

None 

i 

{Na}x{SFAE} 
HLT? Yn 

x is or "<" sign 

Na - Default = last used name operand 
SFAE - Default = 0.0, current EU value 
used for names 

Yn is supplied as response to HLT? query 

70 

Reenable previous trip mode 

None 

i 

None 

Reenables previous trip condition as 
established by last enable command 

70 

Disable variable trip mode 

None 

j 

None 


70 

Accept DATAO control commands 

None 

> 

None 


71 

Accept SAMPLE control commands 

None 

< 

None 


71 

Exit subroutine INFORM 

None 


None 





Data table manipulation 


71 

Clear and open data table 

None 

(u 

{Tn} 

Tn - Default = table 1 

71 

Open data table 

None 

{ 

[Tn} 

Tn - Default = table 1 

72 

Close an open data table 

None 

) 

None 


72 

Add name to open data table 

{Na} 

• 

None 

Na - Default = blank space added to table 

72 

Add name and/or start new line 
on open data table 

{Na} 

- 

None 

Na - Default = no name added before 
new line 

73 

Delete last line from open data table 

None 

t 

None 


73 

Print data table 

{Na} 

\ 

;dF3},{DF4},{DF5} 

DF3 - Default - format type i 

DF4 - Default - data table 1 

DF5 - Default line printer (unit 5) 




Miscellaneous display 


74 

Display current EU value 

{Na} 

* 

None 

Na - Default - last used name operand 

74 

Calculate and display address 

None 

:0 

SFAE 

Address used for names within SFAE 

74 

Calculate and display scale factor 

None 

:1 

SFAE 

Scale factor used for names within SFAE 

75 

Calculate and display EU 

None 

;2 

SFAE 

Current EU value used for names within 
SFAE 

75 

Calculate and display octal words 
of floating-point- real EU value 

None 

:3 

SFAE 

Current EU value used for names within 
SFAE 

75 

List core 

None 

/ 

{Adi} , {Ad2} , {x} , {Sf} , {DFll} 

Adi - Default = last Adi starting address 
Ad2 - Default = last Ad2 end address if 
and only if Adi defaulted 
= Adi if Adi not defaulted 
x - Default = last x data type 
Sf - Default = last Sf scale factor 
DFll - Default = operator's consol (unit 1) 
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INFORM COMMANDS 2 (Continued.) 


Page 


Prefix 

operand 

Key 

character 

Additional operands 

Default values and notes 

Data storage 

76 

Scale and store integer 

{Na} 

ii 

{SFAE} 

Na - Default = last used name operand 

SFAE - Default = 0. 0. Current EU value used for names 

Note: Machine messages appear before and after the SFAE 

Definition control 

77 

Define a named location 

{Na} 

"space” 

{Ad}.{Sf} 

Na - Default - no-name parameter 

Ad - Default = last name operand’s address + I 

Sf - Default = last name operand’ s scale factor 

78 

Redefine a named location 

Na 

"space" 

{xxxxx} , {Ad} , {Sf} 

xxxxx = New name, Default = old name (Na) 
Ad - Default = currently defined address 
Sf - Default = currently defined scale factor 
Note: Na must be currently defined 

79 

Change a default value 

None 

% 

DFn, {No} 

Defaulting No -*• display current value 

79 

Display all INFORM definitions 

None 

? 

{DF12} 

DF12 - Default = line printer (unit 5) 

80 

Display a single INFORM definition 

None 

& 

{Na} 

Na - Default = no-name parameter 

80 

Save INFORM definitions 

None 

i 

{DF9} 

VERIFY? Yn, {DF10} 

DF9 - Default = paper tape punch (unit 2) 

DF10 - Default = paper tape reader (unit 2) 

Note: Yn and DF10 supplied as response to VERIFY query 

81 

Restore INFORM definitions 

None 

* 

{DF10} 

DF10 - Default = paper tape reader (unit 2) 

Display or dump data collected by SAMPLE 

82 

Output SAMPLE channels in format 
type 1 

None 

$i 

{DF6},{DF7},{DF8} 

DF6 = Start channel numbers, default = 0 

DF7 = Stop channel number, default = last channel defined 

DF8 = Default = floppy disk (unit 3) 

84 

Output SAMPLE channels in format 
type 2 

None 

$2 

{DF6},{DF7},{DF»} 

DF6 = Start channel number, default - 0 

DF7 = Stop channel number, default - last channel defined 

DFa - Default = floppy disk (unit 3) 


a Passive mode data table printout defaults: 

DFO - Format type - default - 1 

DF1 - Data table number - Default = I 

DF2 - Output unit number default =■ line printer (unit 5) 
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DATAO CONTROL COMMANDS 


Page 

Description 

Key 

character 

Additional operands 

Default values and notes 

87 

Add a new channel definition 

A 

{Na} , SFAE , SFAE, {Dn} , {Dnn} 

Na - Default value = last used name operand 
Dn - Default = unit number from previous defini- 
tion of this channel 

Dnn - Default = Dac number from previous defini- 
tion of this channel 

88 

Change a channel definition 

C 

xx, {Na} , SFAE, SFAE, {Dn} , {Dnn} 

xx = Channel number 

Na - Default » current name defined for this 
channel 

Dn - Default =* current unit number defined for 
this channel 

Dnn - Default = current Dac number defined for 
this channel 

89 

Delete the highest numbered channel 

D 

None 

Does not affect defaults for "A" and "C M commands 

89 

Delete all channel definitions 

<il 

None 

Does not affect defaults for "A" and "C" commands 

89 

Display all channel definitions 

? 

{DF12} 

DF12 - Default line printer (unit 5) 

89 

Save channel definitions 

1 

{DF9} 

VERIFY? Yn,{DF10} 

DF9 - Default paper tape punch 
DFIO - Default paper tape reader 
Note: Yn and DFIO supplied in response to 
VERIFY? query 

90 

Restore channel definitions 

* 

{DFIO} 

DFIO - Default • paper tape reader (unit 2) 

91 

Accept INFORM commands 

- 

None 

J 




SAMPLE CONTROL COMMANDS 


92 

Add a new channel definition 

A 

{Na} , {Ad} 

Na - Default - last used name operand 
Ad - Default address of highest numbered chan- 
nel defined plus current block length 

93 

Change a channel definition 

C 

xx, {Na} , {Ad} 

xx - Channel number 

Na - Default - current name defined for this 
channel 

Ad - Default current address defined for this 
channel 

93 

Delete last channel definition 

D 

None 

- - 

93 

Delete all channel definitions 

(u 

None 


94 

Display all channel definitions 

*? 

{DF12} 

DF12 - Default = line printer (unit 5) 

94 

Define block length 

B 

BLOCK SIZE = {No} 
# AVERAGES » {No} 

No - Default - current block siz,e, initially - 0 
No - Default - current number of averages, 
initially - 0 

94 

Save channel definitions 

1 

{DF9} 

VERIFY? Yn, [DFIO} 

DF9 - Default - paper tape punch (unit 2) 
DFIO - Default - paper tape reader (unit 2) 
Note: Yn and DFIO supplied in response to 
VERIFY? query 

96 

Restore channel definitions 

* 

{DF10} 

DFIO - Default - paper tape reader (unit 2) 

96 

Accept INFORM commands 

- 

None 
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